Statuses
Status codes for stablecoin payments, settlements and refunds
This page lists the status codes used across stablecoin , and .
This page covers only the statuses for Stablecoin components. The statuses for open banking payments remain unchanged and can be found in the documentation.
Payment statuses
| Status | Description |
|---|---|
NEW | Intent created; no on-chain activity yet. The payer has not sent funds. |
PROCESSING | One or more incoming transactions have been detected and are awaiting confirmations. |
OVERPAID | The payer sent more than the expected amount. Will trigger an auto-refund of the excess or require manual reconciliation. |
UNDERPAID | The payer sent less than the expected amount. Will trigger an auto-refund of the full amount or require manual reconciliation. |
COMPLETED | Expected amount received and confirmed. Terminal success state. |
EXPIRED | The payment time-window elapsed before the consumer confirmed the transaction. |
CANCELED | The payment was cancelled before completion. |
FAILED | The payment failed due to an error. |
ON_HOLD | The payment is paused pending manual review. Can transition back to PROCESSING or to a terminal state. |
Settlement statuses
| Status | Description |
|---|---|
PENDING | Settlement created and queued for processing. |
PROCESSING | Payout submitted to the provider, awaiting completion. |
PAYEE_VERIFICATION_REQUIRED | The payee must be verified before the payout can proceed. |
COMPLETED | Funds successfully sent to the destination. |
FAILED | Settlement failed. |
CANCELLED | Settlement was cancelled. |
RETURNED | Funds were returned by the provider. |
ON_HOLD | Settlement is paused pending review. |
Refund statuses
| Status | Description |
|---|---|
PENDING | Refund created, processing has started. |
PROCESSING | Payout initiated, waiting for completion. |
COMPLETED | Funds successfully returned to the payer. |
FAILED | Refund failed (see failure reason below). |
CANCELLED | Refund was cancelled. |
Refund failure reasons
When a refund ends in FAILED, the response includes a failureReason:
| Failure reason | Description |
|---|---|
INSUFFICIENT_FUNDS | The wallet does not have enough funds. |
WALLET_NOT_FOUND | The specified wallet was not found. |
PAYOUT_CREATE_FAILED | The payout could not be created. |
REJECTED_BY_PROVIDER | The refund was rejected by the provider. |
MANUALLY_CANCELLED | The refund was manually cancelled by the user. |
INTERNAL_ERROR | An internal error occurred. |
How is this guide?
Last updated on