Reference
payment_failed
The payment provider could not be reached.
502HTTP 502 · Payment Failed
What it means
The payment provider could not be reached.
Retry with backoff
Transient. Retry with exponential backoff and jitter, not a fixed interval.
What causes it
- The provider returned an error or timed out.
How to fix it
- Retry with backoff. No charge is made when this is returned.
What the response looks like
502 application/problem+json
{
"error": {
"code": "payment_failed",
"message": "The payment provider could not be reached",
"request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
},
"type": "https://integrable.cloud/docs/errors/payment_failed",
"title": "Payment Failed",
"status": 502,
"detail": "The payment provider could not be reached",
"instance": "/api/bots/01a0652b-3713-7ea1-a6c9-2e895389ec34"
}Branch on error.code, not on the message — the code is stable, the sentence is not. Log request_id either way.
Still stuck
Quote the request_id from the response — hello@integrable.cloud. It is what lets us find the exact request. The full list of codes is at Error codes, and the conventions every endpoint shares are in Retries, versioning and limits.
Something here wrong or missing? Tell us — the documentation and the API are maintained by the same person, so a correction is a fix rather than a ticket.