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

# Payment intent lifecycle

> Every state a payment intent can be in, and what moves it to the next one.

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.

```mermaid theme={null}
stateDiagram-v2
  [*] --> CREATED: Create intent
  CREATED --> REQUIRES_CONFIRMATION
  REQUIRES_CONFIRMATION --> REQUIRES_CAPTURE: Confirm (auto_capture false)
  REQUIRES_CONFIRMATION --> SUCCEEDED: Confirm (auto_capture true)
  REQUIRES_CAPTURE --> SUCCEEDED: Capture
  REQUIRES_CAPTURE --> CANCELED: Cancel
  REQUIRES_CONFIRMATION --> FAILED: Declined
```

| 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](https://docs.mygigsters.com/api-reference/payment-intents/confirm-intent.md). |
| `REQUIRES_CAPTURE` | The customer's bank has authorised the funds and placed a hold. | [Capture intent](https://docs.mygigsters.com/api-reference/payment-intents/capture-intent.md) within 7 days, or [cancel](https://docs.mygigsters.com/api-reference/payment-intents/cancel-intent.md). |
| `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. |

> [!WARNING]
>
> 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](https://docs.mygigsters.com/api-reference/payment-intents/retrieve-intent.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.