This endpoint requires HMAC-SHA256 authentication. See Authentication for signature computation details.
When to Use This Endpoint
- After payment timeout - Check if the payment completed after a 504 response
- Reconciliation - Verify transaction status for accounting purposes
- Status polling - Check on pending transactions
Transaction Status Values
| Status | Description |
|---|---|
PENDING | Transaction created, awaiting terminal response |
COMPLETED | Transaction completed successfully |
FAILED | Transaction failed (check error details in response) |
CANCELLED | Transaction was cancelled |
AWAITING_RECONNECT | Terminal disconnected mid-payment, waiting for reconnection |
VOIDED | Payment was voided (terminal reconnected after grace period) |
Voided Transactions
A transaction may be voided if:- Terminal disconnected during payment processing
- 60-second grace period expired
- Terminal reconnected with a successful payment result
- Payment was automatically voided to prevent orphaned charges
voidedAt and voidReason fields for voided transactions.