Transaction Lifecycle V2
🗺️ Transaction IPN Flow Diagram (Amount Equivalent to Less Than 5,000 USD and Sending Currency EGP)
🗺️ Transaction ACH Flow Diagram (Amount Equivalent to More Than 5,000 USD or Sending Currency USD)
🏷️ Transaction Status Codes
| Code | Status | Definition | Balance Impact | Possible Next Statuses | End State |
|---|---|---|---|---|---|
| 0 | Created | Transaction validated and created but not yet processed. | Amount + fees deducted immediately. | Balad Compliance Suspended, Bank Processing, Canceled | No |
| 1 | Transferred | Final confirmation of successful, irrevocable transfer. | Non-refundable. | — | ✅ Terminal |
| 2 | Bank Processing | Transaction accepted by bank, processing ongoing. | Amount locked. | Ready For Pickup, Transferred, Bank Rejected, Bank Compliance Suspended | No |
| 4 | Returned | Beneficiary bank returned funds after settlement or exceeding pickup time limit. | Amount refunded, fees not refunded. | — | ✅ Terminal |
| 7 | Canceled | Canceled during grace period or manually (cash only). | Amount refunded; fees refunded if within grace period. | — | ✅ Terminal |
| 8 | Pending | Awaiting further action (e.g., funding or review). | Amount locked. | Bank Processing | No |
| 9 | Failed | Failed due to technical errors (not business rejection). | Amount + fees refunded. | — | ✅ Terminal |
| 11 | Balad Compliance Suspended | Transaction flagged for manual compliance review. | Amount locked until decision. | Bank Processing, Balad Compliance Rejected | No |
| 12 | Balad Compliance Approved | Compliance review passed. | Amount locked. | Bank Processing, Pending | No |
| 13 | Balad Compliance Rejected | Compliance review failed. | Amount + fees refunded. | — | ✅ Terminal |
| 15 | Bank Rejected | Rejected by bank due to AML or invalid data. | Amount refunded, fees not refunded. | — | ✅ Terminal |
| 16 | Bank Compliance Suspended | Compliance suspended by bank, processing ongoing. | Amount locked. | Bank Compliance Rejected, Bank Processing | No |
| 17 | Bank Compliance Rejected | Rejected by bank due to AML. | Amount refunded, fees not refunded. | — | ✅ Terminal |
| 19 | Ready For Pickup | Ready for pickup, processing ongoing. | Amount locked. | Transferred, Canceled, Returned | No |
| 20 | Transferred To ACH | Sent to beneficiary bank via ACH, processing ongoing. | Amount locked. | Transferred, Third Party Rejected | No |
| 21 | Third Party Rejected | Rejected by third party due to AML or invalid data. | Amount refunded, fees not refunded. | — | ✅ Terminal |
| 22 | Under Cancellation | Transaction is under cancellation. | Amount locked. | Canceled | No |
How to Track Transaction Status
By API
By Webhook
Make sure you already created a transaction
Follow the above guide to create a transaction and save the
remitter_reference_no.Navigate to Get Transaction Status
Use Get Transaction Status and pass the saved
remitter_reference_no as a path parameter.Review the response
The API will return the current status of the transaction. See Get Transaction Status for full response details.