Webhook
After a payment is processed, or status is changed, you will receive a callback (webhook) containing detailed information about the transaction. It is essential to validate the signature included in the callback to ensure the data's authenticity and integrity. (please refer to the Webhook validation section)
Once the signature is verified, you should synchronize the payment status on your side accordingly.
Below is a detailed list of parameters that may be included in the callback payload:
| Field Name | Type | Required | Description |
|---|---|---|---|
merchant_id | string | Yes | Merchant ID provided by Cashier Technical Support team and used in payment create request |
application_key | string | Yes | Application Key provided by Cashier Technical Support team and used in payment create request |
conversion_rate | float | Yes | Conversion rate between currency and processed currency used during amount conversion |
customer | Object | Yes | Please refer to Customer object description |
session | Object | Yes | Please refer to Session object description |
transaction | Object | No | Please refer to Transaction object description |
version | string | Yes | API version, for now only 1.3 is available |
timestamp | int | Yes | Unix timestamp (Epoch time): Number of seconds (or milliseconds) since January 1, 1970 (UTC). Example: 1716735600 |