Payment Status
Status Codes
Reference documentation for transaction status values returned by The Payment Company APIs, status endpoints, and webhooks.
The status field indicates the current lifecycle state of a pay-in transaction. These values appear in API responses, including the Payment Status API, webhook payloads, and transaction listing endpoints.
Final and transitional states
Treat SUCCESS, FAILED, BLOCKED, and ABANDONED as terminal states, meaning no further payment action is expected. INIT, PENDING, and REDIRECT can still change until the transaction reaches a final outcome.
Status Quick Reference
| Status | Category | Final? |
|---|---|---|
INIT | In progress | No |
PENDING | In progress | No |
REDIRECT | Requires customer action | No |
SUCCESS | Successful | Yes |
FAILED | Unsuccessful | Yes |
BLOCKED | Unsuccessful | Yes |
ABANDONED | Closed without payment | Yes |
Crypto Pay-Ins
Cryptocurrency pay-ins use the same status values listed above, together with an additional field, crypto_payment_status (FULLPAID, UNDERPAID, OVERPAID, or null). Refer to Crypto Payin for fulfillment criteria based on received crypto amount.
Related Docs
- Payment Status API — Check status using
transaction_idororder_id - Webhooks — Server-to-server notifications for status changes
- Payin Transactions — View transactions and their statuses