# Status Reference

Use payment status for merchant order logic. Use attempt and deposit status for payment UI details.

## Payment Statuses

| Status                 | Meaning                                                                              | Recommended merchant action                         |
| ---------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------- |
| `awaiting_payment`     | Payment was created and no funding was observed yet.                                 | Show payment instructions.                          |
| `payment_detected`     | A transfer was observed but funding is not finalized.                                | Show finality progress. Do not fulfill yet.         |
| `partially_paid`       | Some funds finalized, but less than required amount.                                 | Keep order pending or prompt customer to resolve.   |
| `payment_finalized`    | Required funding reached finality.                                                   | Prepare fulfillment, wait for settlement if needed. |
| `settlement_pending`   | Settlement is ready to submit.                                                       | Wait.                                               |
| `settlement_submitted` | Settlement transaction was submitted.                                                | Wait for final settlement.                          |
| `settlement_finalized` | Settlement finalized, but the payment mode may need more completion logic.           | Treat as settled for supported settlement mode.     |
| `completed`            | Payment and settlement completed.                                                    | Fulfill or mark order paid.                         |
| `expired`              | No valid funding arrived before expiry.                                              | Cancel payment or ask customer to create a new one. |
| `underpaid_expired`    | Payment expired after insufficient funding.                                          | Start underpayment support/refund flow.             |
| `overpaid_review`      | More than required amount was received.                                              | Hold fulfillment until review decision.             |
| `manual_review`        | Payment needs operational, risk, compliance, asset mismatch, or late payment review. | Hold fulfillment and escalate.                      |
| `failed`               | Payment cannot complete automatically.                                               | Show failure and contact support path.              |

## Attempt Statuses

| Status                 | Meaning                                                  |
| ---------------------- | -------------------------------------------------------- |
| `pending_terms`        | Attempt terms are not ready yet.                         |
| `awaiting_payment`     | Attempt has instructions and awaits a customer transfer. |
| `payment_detected`     | A transfer was observed but not finalized.               |
| `partially_paid`       | Finalized funding is below required amount.              |
| `payment_finalized`    | Attempt funding reached finality.                        |
| `settlement_pending`   | Settlement is ready.                                     |
| `settlement_submitted` | Settlement transaction was submitted.                    |
| `settlement_finalized` | Settlement transaction finalized.                        |
| `expired`              | Attempt expired.                                         |
| `underpaid_expired`    | Attempt expired underfunded.                             |
| `overpaid_review`      | Attempt needs overpayment review.                        |
| `manual_review`        | Attempt needs manual review.                             |
| `failed`               | Attempt failed.                                          |

## Deposit Statuses

| Status       | Meaning                                                          |
| ------------ | ---------------------------------------------------------------- |
| `pending`    | Artum observed the transfer, but it has zero mock confirmations. |
| `confirming` | Transfer is progressing toward finality.                         |
| `finalized`  | Transfer reached `confirmations_required`.                       |
| `rejected`   | Transfer was observed but cannot fund the payment.               |

In Artum responses, `pending` means observed-but-not-finalized. It does not necessarily mean a strict mempool-pending transaction.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.artum.app/payments/status-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.