Notifications payment

POST https://webhook.example.com

What your webhook implementation will receive when placing a payment

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 or payment operation.

    Values are SUCCESS or FAILURE.

  • type string

    Notification type

    Default value is PAYMENT.

Responses

  • 200

    Your server returns this code if it accepts the callback

POST Payment notification
Request examples
{
  "thirdPartyReference": "REF11",
  "businessLocationId": 247158188015618,
  "status": "SUCCESS",
  "ikentooAccountId": "2114502594134196",
  "ikentooAccountIdentifier": "A123080.14",
  "type": "PAYMENT"
}
{
  "reason": "the payment amount is greater than the amount due",
  "thirdPartyReference": "REF12212",
  "businessLocationId": 141948669832802,
  "status": "FAILURE",
  "ikentooAccountIdentifier": "A78094.73",
  "type": "PAYMENT"
}