Callback
A callback is an asynchronous, server-to-server notification sent from the payment system to your designated callback_url. Its purpose is to reliably inform your system about the final status of a transaction (e.g., successful payment, refund). This process is crucial for securely confirming payment status and automating order updates, as it operates independently of any user action and guarantees data delivery.
Upon receiving a callback, your system must validate the included signature to ensure data integrity and then respond with an HTTP 200 OK status to acknowledge successful receipt.
Request Description (Incoming Callback)
The payment system will send an HTTP POST request to the callback_url you specified when creating the pre-order. This request contains the final status and details of the transaction.
Header
| Header | Type | Description |
|---|---|---|
| Callback-Signature | String | Optional but Recommended. A Base64-encoded signature generated by encrypting the raw request body with the bank's private key using the SHA256withRSA algorithm. You must verify this signature with the provided public key to ensure the callback's authenticity and data integrity. |
Request Body
| Parameter | Type | Description |
|---|---|---|
| event | String | The type of notification. For payment status updates, the value is consistently link_payment. |
| zoned_request_time | String | The timestamp indicating when the callback was sent, formatted in UTC (e.g., "YYYY-MM-DDTHH:MM:SS.ssssssZ"). |
| body | Object | An object containing the full order and payment detail data, similar to the response from the "Get Pre-Order Detail" endpoint. |
- REQUEST
{
"event": "link_payment",
"zoned_request_time": "2026-04-22T11:09:31.458943Z",
"body": {
"pre_order_id": "0873d2db-5bf5-4845-91a3-f25e65f4749d",
"zoned_create_date": "2026-04-21T11:09:31.458943Z",
"zoned_expire_date": "2026-04-22T11:09:31.458943Z",
"pre_order_status": {
"key": "performed",
"value": "Performed"
},
"transaction_status": {
"key": "refunded_partially",
"value": "Partially refunded"
},
"payment_detail": {
"transfer_method": {
"key": "card",
"value": "Card Payment"
},
"transaction_id": "611115529598",
"payer_identifier": "411634***8449",
"order_id": "d300e690-83ba-4f88-afbf-3d3fdaeda95b"
},
"purchase_units": {
"request_amount": "1.0",
"transfer_amount": "0.4",
"refund_amount": "0.6",
"currency_code": "GEL",
"items": null
},
"lang": "ka",
"invoice_payment_url": "https://link.bog.ge/HnisFqRnzJz",
"description": "string",
"external_order_id": "id123"
}
}