Erros

Catálogo completo de códigos e formatos.

Envelope padrão (framework)

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "..."
}

Envelope custom (transacional)

{
  "statusCode": 409,
  "error": "Conflict",
  "message": { "error": { "code": "BUYCARD_NOT_CANCELLABLE", "message": "..." } }
}

Códigos 401

API_KEY_INVALID
INVALID_SECRET
PASSPHRASE_REQUIRED
INVALID_PASSPHRASE

Códigos 403

API_KEY_EXPIRED
API_KEY_REVOKED
API_KEY_FROZEN
MISSING_SCOPE
IP_NOT_ALLOWED
TX_BLOCKED_MED
TX_BLOCKED_TEMP
ACCOUNT_LOCKED
ACCOUNT_BANNED
FIRST_DEPOSIT_CAP
SANDBOX_ONLY

Códigos 409

IDEMPOTENCY_CONFLICT
BUYCARD_NOT_CANCELLABLE

Códigos 429

RATE_LIMIT_EXCEEDED
BURST_EXCEEDED
PROVIDER_BACKPRESSURE
ABUSE_SUSPEND

Códigos 400

VALIDATION_ERROR
SANDBOX_DISABLED

Cookbook

401 = revalide credenciais; 403 com TX_BLOCKED_* = aguarde ou contate suporte; 409 IDEMPOTENCY_CONFLICT = chave já usada com payload diferente, gere outra; 429 = backoff + retry.