Transaction Status Callback

You must expose an endpoint for callback APIs. This endpoint will be used by Eko to update the transaction status. We will assume that the update request has been acknowledged upon receiving a status 200 “Success” from the endpoint.

Note - The callback will be sent only when the status of the transaction is updated from initiated to success or failed.

❗️

Please note that callback will be sent only when the status of the transaction changes from Initiated to Success/Fail/Refund Pending.

👍

URL Structure

Note that only static URL structures are supported.
URL Structure: https://foo.bar/path
Method: POST

We will send the following payload when we hit your URL.

{
  "tx_status": 0,
  "amount": 900.0,
  "payment_mode": "5",  
  "txstatus_desc": "Success",
  "fee": 5.0,
  "gst": 0.76,
  "sender_name": "NETWORK CULTURE",
  "tid": 3211509412,
  "beneficiary_account_type": 1,
  "client_ref_id": "818234",
  "old_tx_status": 2,
  "old_tx_status_desc": "Initiated",
  "bank_ref_num": "409310866471",
  "ifsc": "SBIN0006839",
  "recipient_name": "Jitendra Choudhary Jitendra Choudhary",
  "account": "36367758041",
  "timestamp": "2024-04-02 10:48:41"
}

📘

Please share the callback URL along with your Eko code on mail

Email ID :

[email protected]

Please note that we set a common callback for QR, CMS, Payout and DMT

Transaction status