Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Find the right Payments API failure-recovery page by what you’re seeing, grouped by when it happens.
| Symptom | Signal | Page |
|---|---|---|
No response, or a 503 with no clear outcome | gateway:switch-timeout | Handle timeouts and unknown outcomes |
| A dependency is down or something failed unexpectedly | 503/500 | Retry when the service is unavailable |
| Your access token expired, or lacks scope/outlet | 401 / 403 | Fix rejected or expired access tokens |
| A shopper says they were charged twice, or you see two transactions for one order | Two transactions, two different request_ids | Handle duplicate payments |
| A replay came back different than you expected | 409 idempotency-body-mismatch / 409 duplicate-operation | Handle replays and idempotency conflicts |
| No terminal can currently perform the operation | 409/422 routing errors | Fix operations unavailable for your outlet |
| Symptom | Signal | Page |
|---|---|---|
| The issuer or acquirer refused the card | 201 with status: "DECLINED" | Handle declined payments |
| A timed-out operation resolved itself automatically | REVERSAL_PENDING / REVERSED | Understand automatic reversals |
| Your own 3DS provider’s evidence was rejected | 422/403 three-ds:* | Handle 3DS failures with your own provider |
| Symptom | Signal | Page |
|---|---|---|
| A capture failed on window, amount, or expiry | 422/409 tx:capture-* | Handle capture failures |
| Void or refund on the wrong side of settlement, or over the remaining amount | 409/422 tx:* | Resolve void and refund conflicts |
| A points redemption couldn’t proceed, or the loyalty host timed out | 422 loyalty:* / degraded AUTHORIZED | Handle UOB Rewards redemption failures |
| You tried to void or refund one leg of a redeemed sale | 409/422 transaction:* | Handle UOB Rewards void and refund restrictions |
| Symptom | Signal | Page |
|---|---|---|
| A duplicate, missing, or out-of-order delivery | Repeated/missing event id | Recover from missed, duplicate or out-of-order webhooks |
