notify external provider on entry-code validation failure
Authorization
bearerAuth In: header
Request Body
application/json
AiFi store id
ISO formatted creation time of the event, that caused this webhook to be sent
date-timeISO formatted time, in which this webhook was sent
date-timeA unique token to identify a shopping session. Note, sessionToken and sessionId are same concept in AIFI system.
Customer information
The id of check-in device
Entry code to be verified
Message describing cause of the issue
Error code describing cause of the issue
Response Body
application/json
curl -X POST "https://oasis-api.public.sandbox.oasis.aifi.com/api/push/entry-code/notify" \ -H "Content-Type: application/json" \ -d '{ "storeId": 0, "store": { "oasisApiStoreId": 0, "aifiUniqueStoreId": "string" }, "timeOfOrigin": "2019-08-24T14:15:22Z", "timeOfIssue": "2019-08-24T14:15:22Z", "sessionId": "d3a00526-1864-4f6e-bb2d-46e3ab7fa780", "customer": { "externalId": "string", "metadata": { "arbitraryKey": "arbitraryValue" }, "id": "string", "role": "customer" }, "checkInDeviceId": 0, "entryCode": "string", "errorMessage": "string", "errorCode": 0 }'"string"How is this guide?
customer was created or updated POST
AiFi system shall call this webhook when a customer is created and his personal data is fully collected. Additionally it will be called every time when existing customer's personal data is updated. Personal data considered here is either of [firstName lastName email phoneNumber]. This webhook is intended to be only informative: no response is parsed and no action is taken regardless of the response. **Note**: as an integrator the URL you specify for this webhook is going to be exactly the URL that will be called. For example if you specify "http://example-retailer-api.com/webhook" then exactly "http://example-retailer-api.com/webhook" will be called.
verify entry-code at external provider POST
AiFi system shall call this webhook during the entry-code validation. In regular mode the webhook is only called if both the entry code and the customer owning it were previously registered in AiFi system. However if the QR code passthrough option is turned on (consult your account manager if you need this option turned on) the webhook is called as the first step during the validation. In this case the retailer can optionally return a customerId that will be used to match the customer entity and dynamically create the entry code. If no customerId is returned but status is still OK AiFi will dynamically create both the customer entity and the associated entry code. Retailer or third party can perform their additional checks (such as: pre-authorization of funds etc) and return to AiFi whether their checks succeeded. Take note that AiFi can deny customer the entry without calling this endpoint (for example when the store is closed). AiFi may also deny entry after this call if a payment provider is specified on AiFi side and the payment methods checks fail. Endpoint returns 200 http code also in all instances when the code was successfully examined but rejected for any reason. Http error codes are used only when there are other errors preventing the check such as: 404 reason: 'Customer id <id> not found' **Note**: as an integrator the URL you specify for this webhook is going to be exactly the URL that will be called. For example if you specify "http://example-retailer-api.com/webhook" then exactly "http://example-retailer-api.com/webhook" will be called.