Bila← Docs

Errors

Every error response has the same shape. The request_id is yours to grep on — paste it into a support email and we'll find the request in seconds.

Shape

{
  "error": {
    "type": "invalid_request_error",
    "code": "amount_invalid",
    "message": "amount must be a positive integer in the currency minor unit.",
    "param": "amount",
    "request_id": "req_AbCd..."
  }
}

Types

When to retry

Retry on 429, 500, 502, 503, 504. Never retry 4xx (except 429) — the request will fail the same way.

Idempotency

Pass Idempotency-Key on every mutation. Bila caches the response under the key for 24h, so safe to retry network errors without double-charging.