Notifications order

POST https://webhook.example.com

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
    • clientCount integer(int32)

      The number of guests at the table.

    • identifier string Deprecated
    • uuid string

      The account uuid.

    • openDate string(date-time)

      The date this account was opened in UTC.

    • closeDate string(date-time)

      The date this account was closed in UTC.

    • The total of all payments on the check.

    • The service charge applied to the check.

    • name string

      The check name.

    • The current total amount on the check.

    • The name of the staff member assigned to the check.

    • staffId integer(int64)

      The unique ID of the staff member assigned to the check.

    • salesEntries array[object]

      Collection of check items.

      Hide salesEntries attributes Show salesEntries attributes object
      • id integer(int64)

        The unique ID assigned to the sale line.

      • uuid string

        The UUID assigned to the sale line.

      • itemName string

        The name given to the item.

      • itemSku string

        The SKU assigned to the item.

      • The price per unit.

      • quantity number(double)

        The quantity of the item for this sale line.

      • modifiers array[object]

        The modifiers of the item for this sale line

        Hide modifiers attributes Show modifiers attributes object

        The modifiers of the item for this sale line

        • name string

          The name of the modifier.

        • quantity integer(int32)

          The quantity of the modifier.

      • The total price of the item including tax.

      • The total price of the item without tax.

      • The amount the item was discounted.

      • timeOfTransactionUtc string(date-time)

        The date and time in UTC when the transaction occurred.

      • active boolean Deprecated
      • parentId integer(int64)
      • subLineItems array[object]

        Collection of sub-line items associated with this sale line.

      • Indicates whether tax is included in the unit amount.

    • paymentEntries array[object]

      Payments associated with this check.

      Hide paymentEntries attributes Show paymentEntries attributes object

      Payments associated with this check.

    • id string Deprecated
    • The system-generated account identifier for this check.(Applies to iKentoo V3+).

    • number integer(int32) Deprecated
    • tableNumber integer(int32)

      The table number assigned to the check.

    • posId integer(int64)

      The unique ID of the POS station that processed the check.

    • deviceId integer(int64) Deprecated

Responses

  • Your server returns this code if it accepts the callback

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