Transaction Status Values
Available Status Values
NEW
- Transaction has been created but not yet sent to the payment scheme
- Next states:
AUTHORIZED,PREPARED,REJECTED,DECLINED
AUTHORIZED
- Transaction has been authorized, funds reserved but not captured
- Next states:
CHARGED,REVERSED
CHARGED
- Transaction successfully charged and funds captured
- Next states:
REFUNDED,CHARGEDBACK
REVERSED
- Authorization was reversed before capture (final state)
PREPARED
- Sent to 3DS but not yet completed by the customer
- Next states:
CHARGED,REJECTED,DECLINED
REJECTED
- Rejected by the payment scheme (final state)
DECLINED
- Declined by the payment scheme (final state)
CREDITED
- Funds credited back to the customer (final state)
REFUNDED
- Transaction has been refunded (final state)
CHARGEDBACK
- Charged back by the customer's bank (final state)
FRAUD
- Flagged as fraudulent (final state)
ERROR
- Technical error during processing
- Next states:
NEW(retry),REJECTED
Status Flow
graph TD
A[NEW] --> B[AUTHORIZED]
A --> C[PREPARED]
A --> D[REJECTED]
A --> E[DECLINED]
A --> F[ERROR]
B --> G[CHARGED]
B --> H[REVERSED]
C --> G
C --> D
C --> E
G --> I[REFUNDED]
G --> J[CHARGEDBACK]
G --> K[CREDITED]
F --> A
F --> D
Common Flows
| Flow | Path |
|---|---|
| Successful purchase | NEW → AUTHORIZED → CHARGED |
| 3DS purchase | NEW → PREPARED → CHARGED |
| Reversed authorization | NEW → AUTHORIZED → REVERSED |
| Rejected | NEW → REJECTED |
| Declined | NEW → DECLINED |
| Refund | CHARGED → REFUNDED |
Notes
- All status values are uppercase strings
- Status transitions follow logical business rules
- Some statuses are final states (no further transitions)
- 3DS transactions may remain in
PREPAREDif authentication is not completed
