Transactions accepted by the API can be in one of the following states. As soon as the order is accepted you will get a unique id in the response, which can be used to track the transaction.
Please note that orders rejected up-front by the API with 4xx (authentication or validation errors) are not represented in the state table, since they've never been accepted for processing.
| Status Category | Status | Description | Notes |
|---|---|---|---|
| In Progress | queued | Payment order accepted | Order is accepted and waiting to be submitted for processing |
| In Progress | pending | Payment order pending | Reported by a processor that accepts a payment before it begins processing it |
| In Progress | processing | Payment order is processing | Payment submitted and accepted by processor |
| Success | succeeded | Payment executed successfully | Funds delivered; your balance is debited |
| Failed | failed | Payment failed | Payment failed by the processor |
| Failed | rejected | Payment rejected | Payment rejected by processor or by API during processing (e.g. API could not route) |
| Failed | canceled | Payment is canceled | Cancelled or expired by the processor before it settled; no funds moved |
| Failed | reversed | Payment is reversed | Reversed (and refunded) by the processor after it had succeeded; the debit is credited back |
| Call Support | unknown | Payment state is unknown | Payment has encountered an unknown status at the processor and needs manual intervention |