> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattildapayments.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 your 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.                                                                                                                                                                                                            |
| `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={"dark"}
flowchart LR
    start(( )) --> processing
    processing --> buyer_approval_required
    processing --> failed
    buyer_approval_required --> failed
    buyer_approval_required --> succeeded
    processing --> succeeded
```