PAYMENT_FAILED
The payment verified but could not be settled.
| HTTP status | 402 |
| Group | x402 |
| Retryable | No — sending it again changes nothing |
What happened
Settlement failed on chain — for example the venue was paused or the transfer reverted.
What to do
Request a fresh challenge and pay again. Read the changelog and status page if it repeats.
The problem document
Every error is application/problem+json (RFC 9457) with the same shape:
{
"type": "https://docs.co-relayer.com/errors/payment-failed",
"title": "The payment verified but could not be settled.",
"status": 402,
"detail": "A sentence about this specific occurrence.",
"instance": "req_01JB…",
"code": "PAYMENT_FAILED",
"retryable": false,
"hint": "Request a fresh challenge and pay again. Read the changelog and status page if it repeats."
}
See the error model for what each member means and how to handle unknown codes.