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.