The system will automatically send a callback to the specified webhook URL whenever the status of your transaction changes. The callback contains important information such as the current status, a timestamp, and relevant transaction details (e.g., reference ID, amount, and currency).
{
"status" : "CREATED",
"created_at" : "2006-01-02T15:04:05.999999999Z07:00",
"data" : {
"reference_id":"XXX",
"invoice_currency":"USD",
"amount":1000.00
}
}
Possible Statuses:
The transaction status will update over time. Below are the possible statuses you can expect to receive:
CREATED: The transaction has been initiated and successfully created.
AWAITING_PAYMENT: The transaction has been created, and we are awaiting payment from the payer.
SETTLED: The payment has been successfully completed, and the transaction is settled.
CANCELLED: The transaction has been canceled, either by the user or due to a system action.
DECLINED: The payment was declined by the payer or the payment processor.
Why Use Callbacks?
Callbacks are essential for keeping your application synchronized with the transaction's status in real time. Instead of constantly polling the API to check for updates, your application can react immediately to changes like payments being completed, canceled, or declined.