Skip to main content
There are two kinds of failure:
  1. The request is refused. You get a 4xx or 5xx with an error envelope, and nothing happened. See the error reference.
  2. The payment fails later. The request was accepted with 202, but the rail declined the payment. The payment ends with status: failed and a failure_reason. See Payment failures.

The error envelope

Don’t parse message, and don’t show it to your customers as is. Map the codes you expect to your own wording, and give everything else a generic message.

What each status means

Money requests are always safe to retry with the same idempotency_key. See Idempotency.

A client that handles errors