A sender is a customer who initiates a PPI transaction. Before performing transactions, the sender must be onboarded onto EKO’s platform through the Onboard Sender API, followed by identity verification using Aadhaar and PAN validation. If the sender is already registered, their details can be retrieved using the Get Sender Information API.
Every transaction response will contain a tx_status code with the following possible values:
| tx_status | txstatus_desc |
|---|---|
| 0 | Success |
| 1 | Fail |
| 2 | Initiated |
| 3 | Refund Pending |
| 4 | Refunded |
| 5 | Hold (Transaction Inquiry Needed) |
In case if any other value is returned in tx_status parameter then the transaction should be treated as initiated and transaction inquiry should be done until final status is received.
Transaction Timeout
A transaction can timeout due to multiple reasons, such as, bad internet connection or slow response from the partner bank. In such cases, transaction should not be treated as declined or failed. Ideally, it should be inquired using the Transaction Inquiry API by the passing your own reference number, i.e.,
client_ref_id.