provider_error (502)

← Error reference

provider_error

HTTP status: 502

Retryable: Yes — the request did not change server state.

An upstream provider (KYC vendor, bureau, etc) failed.

When it fires

A downstream third-party returned a non-success response or a network error. We did not mutate any state.

How to handle it

Retry with exponential backoff. Persistent provider errors will appear on the public status page.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/provider_error",
    "code": "provider_error",
    "message": "Upstream provider returned an error",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/provider_error"
  }
}