error.code.
Error format
Validation errors
A request body that fails validation returns422 with the failing fields:
The short format
Some responses come straight from the web framework and have noerror.code. Authentication failures, an unknown URL and a malformed id in a URL look like this:
Write one error handler that copes with both formats: if
error is an object, use error.code;
if error is a string, use the HTTP status and the top-level message.HTTP statuses
Error codes
The Status column shows the HTTP status where the code always arrives with the same one.Validation
validation_missing_field is also the code on a few 400 responses that have no more specific code. Read the message and details.code.
Idempotency
Wallets
Quotes
Resources
Channels
A channel is the bank or operator connection that carries a payment.Authentication and permission
Compliance and limits
Rate limiting and server errors
Payouts that fail later
A payout can be accepted with202 and fail afterwards, for example when the recipient’s bank rejects it. That is not an HTTP error. You learn of it from the payout.failed webhook or from GET /v1/payouts/{id}, where userMessage gives the reason in plain words.

