Stablecoin payin states

Managed Payments tracks stablecoin payins using three resources: PaymentIntent, Payment, and Refund. Each resource moves through a set of states as the payin progresses.

PaymentIntent states

A PaymentIntent is created when you request a deposit address. Its state shows whether the address is ready and whether funds have settled.

State	Description
`pending`	The deposit address is being provisioned and is not yet ready.
`paid`	At least one payment has settled. For continuous intents, monitor individual `Payment` objects for each settlement. Terminal state.
`failed`	The intent could not be fulfilled. Terminal state.
`expired`	The `expiresOn` time passed with no payment received. No further payments are accepted. Applies to transient intents only. Terminal state.

Transient intents expire when the expiresOn timestamp is reached with no payment received. Continuous intents do not expire.

Payment states

A Payment is created each time funds arrive at the deposit address. Its state shows whether the payment settled.

State	Description
`pending`	An onchain payment was detected and settlement is in progress.
`paid`	The payment settled successfully. Terminal state.
`failed`	The payment failed. Check `statusReason` for the reason. Terminal state.

Refund states

A Refund is created when funds from a Payment are returned to the sender. Its state shows whether the refund was delivered.

State	Description
`pending`	The refund was initiated and settlement is in progress.
`paid`	The refund was delivered successfully. Terminal state.
`failed`	The refund could not be delivered. Check `errorCode` for the reason. Terminal state.

Status reasons

The statusReason field provides additional context for certain Payment states. Values relate to Personally Identifiable Information (PII) and Virtual Asset Service Provider (VASP) data required for Travel Rule compliance. All values in the following table apply to Circle Singapore (CIRCLE_SG) merchants.

Status	`statusReason`	Description
`pending`	`compliance_review`	Compliance is awaiting PII before releasing funds.
`pending`	`unsupported_wallet`	Compliance is awaiting PII. The sending wallet is unsupported.
`pending`	`awaiting_pii`	The payment is awaiting PII. Circle will reach out for collection.
`pending`	`unsupported_wallet_awaiting_pii`	The payment is awaiting PII. The sending wallet is unsupported.
`paid`	`unsupported_wallet`	Funds settled but were received from an unsupported VASP.
`paid`	`pii_not_received`	Funds settled, but the sender’s VASP never supplied the Travel Rule PII in the collection window.
`paid`	`unsupported_wallet_pii_not_received`	Funds settled after the collection window closed with no PII received, and the sending wallet is unsupported.
`failed`	`compliance_denied`	Funds seized due to sanctions hit.

States with a link in the Payment states table have a corresponding webhook event. failed has no webhook.

Fiat payouts

Managed Payments

Stablecoin payments

Stablecoin payin states

PaymentIntent states

Payment states

Refund states

Status reasons

​PaymentIntent states

​Payment states

​Refund states

​Status reasons

PaymentIntent states

Payment states

Refund states

Status reasons