Erori și recuperare
Erorile includ error.code, error.message și error.request_id; validarea poate include field_errors. Păstrează X-Request-Id pentru suport, fără chei sau date personale.
| Cod | Ce faci |
|---|---|
| 401 INVALID_API_KEY | Verifică cheia, revocarea sau termenul ales în cabinet. Cheile indefinite nu cer reînnoire. |
| 403 INSUFFICIENT_SCOPE | Verifică permisiunile, locațiile, autorizarea/asocierea financiară și fereastra de export a afacerii. |
| 404 | Verifică resursa autorizată. Un ID nativ din istoric nu este automat un ID financiar. |
| 409 IDEMPOTENCY_CONFLICT | Recuperează UUID-ul și corpul original; nu schimba UUID-ul ca să ocolești un rezultat incert. |
| 409 STALE_QUOTE / QUOTE_EXPIRED | Citește starea și cere o ofertă nouă înaintea unei încercări noi verificate. |
| 409 STALE_REVISION / CARD_RESERVED | Citește rezervarea și verifică operația existentă; nu începe altă plată. |
| 409 REFUND_ALLOCATION_MISMATCH | Folosește valorile brute inițiale și alocarea cumulativă, inclusiv banii neeligibili returnați. |
| 410 CURSOR_EXPIRED | Refă exportul complet. Endpointurile retrase au propriul cod 410. |
| 422 INVALID_CURSOR / VALIDATION_ERROR | Corectează parametrii. La listele de configurație, reîncepe de la pagina 1 după expirarea cursorului de o oră. |
| 423 SERVICE_SUSPENDED | Operațiunile financiare nu sunt disponibile; rezolvă starea serviciului în cabinet. |
| 429 RATE_LIMITED | Respectă Retry-After și împarte cererile în bugetul comun al conexiunii. |
| 503 sau timeout | Păstrează UUID-ul și corpul, mărește intervalul de așteptare și verifică/reconciliază operațiunea incertă înainte de repetare. |