Lightspeed Restaurant K Series API
1.0.0

Lightspeed Restaurant offers a REST API in order to communicate with the data in the system. These APIs are built using the RESTful standards and adhere to the basic verb interactions as defined by the REST standard.

These services are in continuous development and subject to change. Find our versioning policy here.

This is the documentation for version 1.0.0 of the API. Last update on May 1, 2024.

Base URL
https://api.trial.lsk.lightspeed.app

Notifications order

POST /Order notification

What your webhook implementation will receive when placing an order

application/json

Body Required

  • reason string

    Reason for failure if there is one

  • Third-party reference you provided when the order or payment was placed.

  • businessLocationId integer(int64)

    The unique identifier of the business location.

  • The K-series account identifier for a SUCCESS event (V3 format)

  • iKentooAccountId integer(int64) Deprecated

    The K-series account identifier for a SUCCESS event (V2 format)

  • status string

    Status of the order operation.

    Values are SUCCESS, FAILURE, IN_DELIVERY, READY_FOR_PICKUP, CLOSED, ABANDONED, or CANCELLED.

  • type string

    Notification type

    Default value is ORDER.

  • account object
    Hide account attributes Show account attributes

Responses

  • 200

    Your server returns this code if it accepts the callback

POST Order notification
{
  "status": "SUCCESS",
  "ikentooAccountId": "2114502594134196",
  "ikentooAccountIdentifier": "A123080.14",
  "thirdPartyReference": "REF11",
  "type": "ORDER"
}
{
  "thirdPartyReference": "order-wFUBVgHNGPAJsryIrSaE",
  "businessLocationId": 247158188015618,
  "status": "READY_FOR_PICKUP",
  "account": {
    "clientCount": 2,
    "uuid": "5a81c7f4-9e2f-4db2-965d-6946a4f9c25b",
    "openDate": "2021-12-21T13:24:49.265+0000",
    "paidAmount": "4.00",
    "serviceCharge": "0.00",
    "name": "Order NZVV",
    "currentAmount": "4.00",
    "staffName": "Manager",
    "staffId": 31930,
    "salesEntries": [
      {
        "id": 304087979524125,
        "itemName": "Appetizer 2",
        "itemSku": "21",
        "unitAmount": "4.00",
        "quantity": 1,
        "modifiers": [],
        "amountWithTax": "4.00",
        "amountLessTax": "3.33",
        "discountedAmount": "0.00",
        "grossUnitAmount": "4.00",
        "active": true,
        "taxIncluded": true
      }
    ],
    "paymentEntries": [
      {
        "paymentMethodDescription": "API Payment",
        "externalReference": "1234567890",
        "paymentMethodCode": "APM",
        "amountPaid": "4.00",
        "paymentDate": "2021-12-21T13:25:25.082+0000",
        "active": true
      }
    ],
    "ikaccountId": "A17700.3",
    "tableNumber": 3,
    "posId": 17700
  },
  "ikentooAccountId": 304087979524124,
  "ikentooAccountIdentifier": "A17700.3",
  "type": "ORDER"
}
{
  "status": "FAILURE",
  "reason": "A consumer already exists for this email address with a different external reference.",
  "thirdPartyReference": "REF12212"
}
{
  "thirdPartyReference": "order-wFUBVgHNGPAJsryIrSaE",
  "businessLocationId": 247158188015618,
  "status": "SUCCESS",
  "account": {
    "clientCount": 2,
    "uuid": "5a81c7f4-9e2f-4db2-965d-6946a4f9c25b",
    "openDate": "2021-12-21T13:24:49.265+0000",
    "paidAmount": "0.00",
    "serviceCharge": "0.00",
    "name": "Order NZVV",
    "currentAmount": "4.00",
    "staffName": "Online Order",
    "staffId": 31930,
    "salesEntries": [
      {
        "id": 304087979524125,
        "uuid": "1b8d016e-2c7f-456d-9349-8476eacd99bf",
        "itemName": "Appetizer 2",
        "itemSku": "21",
        "unitAmount": "4.00",
        "quantity": 1,
        "modifiers": [],
        "amountWithTax": "4.00",
        "amountLessTax": "3.33",
        "discountedAmount": "0.00",
        "grossUnitAmount": "4.00",
        "timeOfTransactionUtc": "2023-11-08T13:33:52.641+0000",
        "active": true,
        "subLineItems": [],
        "taxIncluded": true
      }
    ],
    "paymentEntries": [],
    "ikaccountId": "A17700.3",
    "tableNumber": 3,
    "posId": 17700
  },
  "ikentooAccountId": 304087979524124,
  "ikentooAccountIdentifier": "A17700.3",
  "type": "ORDER"
}
{
  "thirdPartyReference": "order-wFUBVgHNGPAJsryIrSaE",
  "businessLocationId": 247158188015618,
  "status": "CHECK_WAS_UPDATED",
  "account": {
    "clientCount": 2,
    "uuid": "5a81c7f4-9e2f-4db2-965d-6946a4f9c25b",
    "openDate": "2021-12-21T13:24:49.265+0000",
    "paidAmount": "4.00",
    "serviceCharge": "0.00",
    "name": "Order NZVV",
    "currentAmount": "4.00",
    "staffName": "Manager",
    "staffId": 31930,
    "salesEntries": [
      {
        "id": 304087979524125,
        "itemName": "Appetizer 2",
        "itemSku": "21",
        "unitAmount": "4.00",
        "quantity": 1,
        "modifiers": [],
        "amountWithTax": "4.00",
        "amountLessTax": "3.33",
        "discountedAmount": "0.00",
        "grossUnitAmount": "4.00",
        "active": true,
        "taxIncluded": true
      }
    ],
    "paymentEntries": [
      {
        "paymentMethodDescription": "API Payment",
        "externalReference": "1234567890",
        "paymentMethodCode": "APM",
        "amountPaid": "4.00",
        "paymentDate": "2021-12-21T13:25:25.082+0000",
        "active": true
      }
    ],
    "ikaccountId": "A17700.3",
    "tableNumber": 3,
    "posId": 17700
  },
  "ikentooAccountId": 304087979524124,
  "ikentooAccountIdentifier": "A17700.3",
  "type": "ORDER"
}
{
  "thirdPartyReference": "order-wFUBVgHNGPAJsryIrSaE",
  "businessLocationId": 247158188015618,
  "status": "CLOSED",
  "account": {
    "clientCount": 2,
    "uuid": "5a81c7f4-9e2f-4db2-965d-6946a4f9c25b",
    "openDate": "2021-12-21T13:24:49.265+0000",
    "paidAmount": "4.00",
    "serviceCharge": "0.00",
    "name": "Order NZVV",
    "currentAmount": "4.00",
    "staffName": "Manager",
    "staffId": 31930,
    "salesEntries": [
      {
        "id": 304087979524125,
        "itemName": "Appetizer 2",
        "itemSku": "21",
        "unitAmount": "4.00",
        "quantity": 1,
        "modifiers": [],
        "amountWithTax": "4.00",
        "amountLessTax": "3.33",
        "discountedAmount": "0.00",
        "grossUnitAmount": "4.00",
        "active": true,
        "taxIncluded": true
      }
    ],
    "paymentEntries": [
      {
        "paymentMethodDescription": "API Payment",
        "externalReference": "1234567890",
        "paymentMethodCode": "APM",
        "amountPaid": "4.00",
        "paymentDate": "2021-12-21T13:25:25.082+0000",
        "active": true
      }
    ],
    "ikaccountId": "A17700.3",
    "tableNumber": 3,
    "posId": 17700
  },
  "ikentooAccountId": 304087979524124,
  "ikentooAccountIdentifier": "A17700.3",
  "type": "ORDER"
}