API reference
Errors
HTTP status codes and what to do about them.
| HTTP | Body | What to do |
|---|---|---|
| 400 | {"detail": "Idempotency-Key header is required…"} | Add a valid Idempotency-Key. |
| 401 | {"detail": "Invalid or missing API key"} | Check the key and environment; it may have been rolled. |
| 404 | {"error": "not_found"} | Unknown reference, or it belongs to another business. |
| 409 | {"detail": "This Idempotency-Key was already used…"} | Use a new key for a different request. |
| 422 | {"detail": [{"loc": […], "msg": "…"}]} | Fix the field named in loc. |
| 422 | {"error": "payment_refused", "message": "…"} | Refused by the business’s blacklist or limit. Show the message to the customer. |
| 429 | {"detail": "Rate limit exceeded"} | Wait for Retry-After seconds. |
| 502 | {"detail": "The acquirer could not be reached…"} | The payment stays pending. Check it later with GET or verify; do not create a new one. |
| 503 | {"error": "acquirer_not_configured", …} | The payment channel is temporarily unavailable. Try again later. |