ServiceUnavailable 503

When does this happen?

A downstream dependency (database or payment rail) is temporarily unavailable.

Example response

{
  "_tag": "ServiceUnavailable",
  "type": "ServiceUnavailable",
  "message": "Database unavailable",
  "retryAfter": 30,
  "docs_url": "https://docs.borderli.dev/errors/ServiceUnavailable"
}

What to do

Retry after retryAfter seconds with exponential backoff. Use the same idempotency key for payment operations.

← Back to Error Handling