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

# Lifecycle

> Understand how payments move through statuses from creation to completion.

Payments follow a unified status flow regardless of processor, making it easy to build consistent payment experiences. Depending on the payment method, a payment may skip statuses that do not apply to it.

## Status Flow

<div className="block dark:hidden">
  ```mermaid theme={"system"}
  flowchart LR
      A(["※ Pending"]) --> B(["✓ Authorized"])
      B --> C(["↻ Settling"])
      C --> D(["✓ Settled"])
      A --> C
      
      A --> E(["※ Incomplete"])
      A --> F(["× Declined"])
      A --> G(["× Failed"])
      A --> H(["× Blocked"])
      
      B --> I(["× Cancelled"])
      C --> I

      style A fill:#f1f5f9,stroke:#64748b,color:#334155
      style B fill:#dcfce7,stroke:#16a34a,color:#14532d
      style C fill:#f1f5f9,stroke:#64748b,color:#334155
      style D fill:#dcfce7,stroke:#16a34a,color:#14532d
      style E fill:#f1f5f9,stroke:#64748b,color:#334155
      style F fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
      style G fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
      style H fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
      style I fill:#fef9c3,stroke:#ca8a04,color:#713f12
  ```
</div>

<div className="hidden dark:block">
  ```mermaid theme={"system"}
  flowchart LR
      A(["※ Pending"]) --> B(["✓ Authorized"])
      B --> C(["↻ Settling"])
      C --> D(["✓ Settled"])
      A --> C
      
      A --> E(["※ Incomplete"])
      A --> F(["× Declined"])
      A --> G(["× Failed"])
      A --> H(["× Blocked"])
      
      B --> I(["× Cancelled"])
      C --> I

      style A fill:#1e293b,stroke:#475569,color:#cbd5e1
      style B fill:#14532d,stroke:#16a34a,color:#bbf7d0
      style C fill:#1e293b,stroke:#475569,color:#cbd5e1
      style D fill:#14532d,stroke:#16a34a,color:#bbf7d0
      style E fill:#1e293b,stroke:#475569,color:#cbd5e1
      style F fill:#7f1d1d,stroke:#dc2626,color:#fecaca
      style G fill:#7f1d1d,stroke:#dc2626,color:#fecaca
      style H fill:#7f1d1d,stroke:#dc2626,color:#fecaca
      style I fill:#713f12,stroke:#ca8a04,color:#fef08a
  ```
</div>

<Note>
  Some payment methods have no authorization/capture separation. Instant account-to-account methods such as Pix (Pix Automático) never enter `AUTHORIZED` — the payment moves from `PENDING` directly to `SETTLING` or `SETTLED`.
</Note>

## Status Definitions

| Status       | Description                                          |
| ------------ | ---------------------------------------------------- |
| `PENDING`    | Payment created, awaiting processing                 |
| `AUTHORIZED` | Funds reserved with issuer, awaiting settlement      |
| `SETTLING`   | Settlement in progress with processor                |
| `SETTLED`    | Funds transferred, payment complete                  |
| `INCOMPLETE` | Customer abandoned checkout (e.g., closed 3DS modal) |
| `DECLINED`   | Rejected by issuer or processor                      |
| `FAILED`     | Technical error prevented processing                 |
| `BLOCKED`    | Denied by workflow rules before processing           |
| `CANCELLED`  | Payment voided before settlement completed           |

<Note>
  Refunds can be issued for payments in `SETTLING` or `SETTLED` status. Refunded payments retain their original status—refund details are returned as a separate object in the API response and can be filtered in the Dashboard.
</Note>