> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useagentbank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment statuses

> Interpret AgentBank durable payment states and choose the next safe action.

| Status | Meaning | Next action |
| - | - | - |
| `approval_required` | World ID payment authorization is pending | Open the returned first-party action and keep the same payment |
| `approval_ready` | Authorization is satisfied | Call `continue_payment` |
| `funding_required` | A fiat or wallet funding instruction is ready | Follow the current instruction |
| `funding_detecting` | AgentBank is detecting or verifying funding | Poll `get_payment` |
| `processing` | Funds moved and the route is processing | Poll at the returned cadence; do not fund again |
| `need_review` | A readiness or manual review condition blocks progress | Read the reason and do not duplicate the payment |
| `recipient_correction_required` | Settlement is paused for corrected recipient details | Confirm and call `correct_payment_recipient` |
| `completed` | The aggregate payment completed | Report completion |
| `cancelled` | The durable payment was cancelled | Stop |
| `expired` | The current payment or funding window expired | Read `failure`, confirm that funds did not move, and estimate again if the user wants to retry |
| `funding_timeout` | Funding was not detected before the payment's funding window closed | Read `funds_moved` and the returned recovery guidance before creating anything new |
| `failed` | The payment reached a terminal failure | Show failure details and whether funds moved |

`get_payment` is authoritative. A transaction hash, completed hop, or hosted
card state does not replace the aggregate payment status.