Payment intent lifecycle

A payment intent moves through a fixed set of states. Knowing them tells you when funds are held, when they’re taken, and what to do next.

State	What it means	What to do next
`CREATED`	The intent exists with an amount, job, and currency. No money is held yet.	Confirm the intent.
`REQUIRES_CONFIRMATION`	Waiting for payment details, the customer’s default card, to be provided by a confirm request.	Confirm intent.
`REQUIRES_CAPTURE`	The customer’s bank has authorised the funds and placed a hold.	Capture intent within 7 days, or cancel.
`SUCCEEDED`	The funds have been captured and processed. Payouts can now be scheduled using these funds.	Nothing. Refund later if needed.
`CANCELED`	The intent was cancelled before capture, releasing the hold on the customer’s card.	Nothing.
`FAILED`	The transaction failed because of insufficient funds, card expiry, or another bank decline.	Ask the customer for another card and create a new intent.

A hold lasts 7 days. Capture within that window or the authorisation lapses.

Check an intent’s current state at any time with Retrieve intent.

Last modified on November 10, 2026