Response statuses

Technical Author Note

Status values verified. Capture status to be confirmed before publication.

The status field in the response body tells you the outcome of an operation. Always read it before updating your system.

Status	Meaning
pending	Accepted and queued for the card network. Normal outcome for sales, payouts, funding, and refunds.
success	Confirmed by the network. Normal outcome for pre-auth authorisations and cancellations.
fail	Declined or errored. The body contains a failure object with code and reason.
unknown	Outcome indeterminate at response time. Treat as potentially in-flight; check status before retrying.

note

HTTP 201 Created only confirms the gateway received the request. The real outcome is in the status field of the response body.