Skip to main content

QR API Webhooks

The QR solution currently has one webhook event a merchant can subscribe to.

The central part of the Merchant Callback QR flow is the callback that will be sent to the merchant when a customer scans the QR. To receive these callbacks, the merchant needs to register a subscription to the user.checked-in.v1 webhook event.

Here is the payload for the user.checked-in.v1 event:

NameTypeDescription
customerTokenbase64 stringA reference to the customer. Should be used when initiating a payment through the ePayment API.
merchantQrIdstringThe ID of the QR code that has been scanned which is defined by the merchant when the QR was created.
merchantSerialNumberstringA unique ID of the sales unit to which the scanned QR belongs.
initiatedAtUTC Timestamp in ISO 8601 formatThe timestamp of when the customer scanned the QR.

Example of user.checked-in.v1 payload:

{
"customerToken": "wbA8ceVRKkoYiQAVELHeFCC3Sn5dtNCvvEtVPiOT77j6wx7uR965AG6Q+q0ATP4=",
"merchantQrId": "d8b7d76d-49aa-48b8-90c6-38779372c163",
"merchantSerialNumber": "12345",
"initiatedAt": "2023-10-06T10:45:40.3061965Z"
}

See the Webhooks API for more information.

Help us improve our documentation

Did you find what you were looking for?