---
excludeFromSearch: true
---

# Payment states

The `PaymentState` field of the payment object indicates the current state of a payment. A payment can only be in one state at any given time, so each subsequent state overrides previous states. This page lists the supported payment states and provides information on how to find a specific payment's current state and past states.

## Ripple Payments Direct payment states

The following table lists all supported payment states.

| <div style="width:180px">State</div> | Description                                  |
|:--------------------------------:|:-------------------------------------------------|
| `QUOTED`                        | A quote has been created, but you haven't accepted it yet to initiate a payment. **Note:** This state is not shown as part of the payment detail as the payment doesn't exist yet. |
| `INITIATED`                      | You, the payment originator, have initiated a payment. The payment now has a unique `paymentId` that's the same as the `quoteId` of the quote you accepted. |
| `VALIDATING` | Ripple validates the payment details and reserves funds from your available balance to complete the payment. |
| `TRANSFERRING`                      | The payment is moving through the network to the ultimate beneficiary. The payment amount is debited from your available balance. |
| `COMPLETED`                      | The payment is complete and the beneficiary has received the funds. |
| `FAILED`                     | The payment failed. The failure reason, if available, is listed in the response. Funds that were previously reserved to complete the payment are released and added back to the available balance. |

<!-- TODO: Afer API launch, update the description for QUOTED and say that the state is present in the response from the state transition operation. -->
## How to check the payment state

You can check a payment's current state and its state transition history in the {% $env.PUBLIC_VAR_RNH %} <!-- or by using the {% $env.PUBLIC_VAR_RPD %} API -->.

### Check the payment state in the {% $env.PUBLIC_VAR_RNH %}

The [Payment details page](/user-interface/payments/payment-details.md) in the {% $env.PUBLIC_VAR_RNH %} provides information about a payment's state transitions and its current state.

The Payment Details tab shows the payment's transition through various states starting with the `INITIATED` state. The timestamp associated with each state specifies when the payment reached that state. 

In the Payment Object JSON tab, the `paymentState` field shows the *current* state of the payment. 

<!-- ### Check the payment state using the {% $env.PUBLIC_VAR_RPD %} API

To check the current state of a specific payment, call the [Get a payment by ID] operation with the payment's unique `paymentId`. The response body includes the `paymentState` field whose value indicates the payment's current state. <!-- add hyperlink to API ref when available -->

<!-- To check a payment's state transition history, call the [GET state transitions by payment ID] operation with the unique `paymentId`. The response contains an array of objects that show the the payment's transition between states and the time at which the state transition happened. -->