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

# Payment method statuses

> A list of all statuses for payment methods.

A payment method's `status` value can be one of the following depending on the
state within the system and the status within the used payment service.

| `status`                  | Description                                                                                                                                                                                                                                                                       |
| :------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `processing`              | The payment method record has been created in the system and is now ready to be used with payment services. The status is still `processing` because the payment method has not been validated through a transaction. The `id` method can now be used to create new transactions. |
| `failed`                  | The payment method could not be processed with any payment service due to technical issues.                                                                                                                                                                                       |
| `buyer_approval_required` | The payment method was correctly created but needs approval from the buyer. This is mainly used in alternative payment methods like PayPal where the user needs to be redirected to complete the payment method.                                                                  |
| `succeeded`               | The payment method was successfully used in any payment service.                                                                                                                                                                                                                  |

# State diagram

The following state diagram serves as an overview of all the different `status`
values and how they relate to each other.

```mermaid theme={"system"}
flowchart LR
    start(( )) --> processing
    processing --> buyer_approval_required
    processing --> failed
    buyer_approval_required --> failed
    buyer_approval_required --> succeeded
    processing --> succeeded
```