Callback Requests We Make

After a transaction is completed, our backend will send a callback request to the given url. (callback url is set by you when the transaction is created)

---

We also initially send a callback which follows right after the creation of request with paymentStatusCode 0 (AWAITING) so you get this status at first.

After any action taken for the transaction on our side like APPROVED/DENIED or IN REVIEW, we send another callback with the most recent valid paymentStatusCode like 2 (APPROVED) or 4 (DECLINED)

*We do not send any callback for IN REVIEW (paymentStatusCode: 1) state since it is not necessary on your side.

So the last callback request parameters should be considered as the most recent valid status of the transaction.

0 : Awaiting

1 : In Review

2 : Approved

4 : Declined

---

Here are the sample requests:

Successful Transaction callback

{
    "apiKey": "YOUR_API_KEY",
    "transactionId": "123123123",
    "memberId": "98765",
    "memberFullName": "John Doe",
    "amount": 100,
    "checksum": "8cd1dc028785**************3866886e",
    "paymentStatus": true,
    "paymentStatusCode": 2,
    "paymentStatusDescription": "Payment Approved",
    "paymentStatusReason": "Progress Successful"
}

Failed Transaction Callback

{
    "apiKey": "YOUR_API_KEY",
    "transactionId": "123123123",
    "memberId": "98765",
    "memberFullName": "John Doe",
    "amount": 100,
    "checksum": "287858ed63bfdc025**************728fnd6kl",
    "paymentStatus": false,
    "paymentStatusCode": 4,
    "paymentStatusDescription": "Payment Declined",
    "paymentStatusReason": "Invalid Information"
}

Callback Checksum formula:

hash("sha256", "api_key|api_secret|amount|transactionId|paymentStatusCode")