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 |
