Get payment status
Returns the current status of a payment. Use this endpoint to reconcile
a payment that settlement left unresolved with
errorReason: settlement_pending.
Status values are pending, completed, or failed.
Authorizations
Bearer token authentication with a Circle API key. Use this for
production settlement. Settling with an API key also binds the payTo
to your Circle account, which ends the keyless trial allowance.
Path Parameters
The paymentId returned by /settle on a pending response.
Response
Payment status
Facilitator Service payment identifier.
"5b3f6c1e-9d2a-4f08-b1c7-2e9a14d0c3aa"
Current lifecycle state of the payment.
pending, completed, failed CAIP-2 network identifier for the payment.
"eip155:5042002"
Additional detail about the payment status.
outcome_unknown "outcome_unknown"
Transaction hash once available.
"0x6f9e1d..."
Amount in atomic USDC units.
"1000000"
Buyer address on the settled transfer.
null
Reserved poll-hint field. Always null: /status does not advertise a
next action. Callers choose their own reconcile cadence.
null
Reserved poll-hint field. Always null: /status does not advertise a
retry cadence. Callers choose their own reconcile interval. The
support deadline is expiresAt.
null
Support deadline for this unresolved payment. Reconciliation
continues past it. Present only while status is pending.
Timestamp of the most recent state transition.
"2026-06-11T22:30:11Z"