Cuprinsul documentației

Ghid de integrare

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.

CodCe faci
401 INVALID_API_KEYVerifică cheia, revocarea sau termenul ales în cabinet. Cheile indefinite nu cer reînnoire.
403 INSUFFICIENT_SCOPEVerifică permisiunile, locațiile, autorizarea/asocierea financiară și fereastra de export a afacerii.
404Verifică resursa autorizată. Un ID nativ din istoric nu este automat un ID financiar.
409 IDEMPOTENCY_CONFLICTRecuperează UUID-ul și corpul original; nu schimba UUID-ul ca să ocolești un rezultat incert.
409 STALE_QUOTE / QUOTE_EXPIREDCitește starea și cere o ofertă nouă înaintea unei încercări noi verificate.
409 STALE_REVISION / CARD_RESERVEDCitește rezervarea și verifică operația existentă; nu începe altă plată.
409 REFUND_ALLOCATION_MISMATCHFolosește valorile brute inițiale și alocarea cumulativă, inclusiv banii neeligibili returnați.
410 CURSOR_EXPIREDRefă exportul complet. Endpointurile retrase au propriul cod 410.
422 INVALID_CURSOR / VALIDATION_ERRORCorectează parametrii. La listele de configurație, reîncepe de la pagina 1 după expirarea cursorului de o oră.
423 SERVICE_SUSPENDEDOperațiunile financiare nu sunt disponibile; rezolvă starea serviciului în cabinet.
429 RATE_LIMITEDRespectă Retry-After și împarte cererile în bugetul comun al conexiunii.
503 sau timeoutPăstrează UUID-ul și corpul, mărește intervalul de așteptare și verifică/reconciliază operațiunea incertă înainte de repetare.