Operare în producție
Depanare: de la simptom la cauză
Probleme reale de integrare și pașii de verificare, fără retry orb sau schimbarea beneficiarilor.
Exemple server-side cu SDK-urile oficiale Monedo. Înlocuiește identificatorii și configurația cu resursele propriei instalări. Datele din exemple nu sunt tranzacții reale.
Începe cu request ID-ul
Mesajul generic «Edge Function returned a non-2xx status code» nu este cauza. Citește corpul JSON al răspunsului în backend, HTTP status, error.code, error.param și x-request-id. Păstrează metoda, ruta, ora UTC, mediul și identificatorii resurselor. Nu include cheia secretă, semnătura webhook, client_secret sau datele cardului în ticket ori loguri.
Simptome frecvente
| Simptom | Verificări |
|---|---|
| Link /pay/undefined | Citește session.checkout_url din răspunsul valid; nu construi URL-ul concatenând o proprietate care poate lipsi. |
| Comerciant nerecunoscut | Commerce cere mer_... autorizat. Fiscal are alt contract de identificare. Verifică aplicația, grantul și mediul. |
| Captură acceptată, comandă neplătită | Verifică statusul final prin API/webhook; 2xx nu înseamnă succeeded. |
| Clientul a plătit, comerciantul nu vede settlement | Separă încasarea de distribuție. Urmărește operația și beneficiarii; nu dubla transferul. |
| Idempotency: parametrii diferă | Reia payloadul inițial sau creează explicit o nouă operație pentru parametri noi. |
| Confirmarea cere return_url | Configurează URL-ul de retur înregistrat pentru fluxul de confirmare; nu inventa redirecturi din date client. |
| Webhook absent sau întârziat | Verifică endpointul, mediul, evenimentele selectate, semnătura, logurile livrării și timpul de răspuns. |
| PDF/email întârzie | Citește livrarea; nu emite altă factură pentru a retriggera randarea. |
| Catalog incomplet | Verifică selecția comerciantului, locația, paginarea și cursorul de sincronizare. |
| Refund refuzat | Verifică suma rambursabilă, recuperarea fondurilor și starea operațiilor. Nu muta costul către alt merchant. |
Ce trimiți către suport
- Aplicația, mediul Sandbox/Live și ora UTC a încercării.
- Metoda + ruta și request ID; event ID pentru webhook.
- ID-ul comenzii/plății/abonamentului și rezultatul așteptat.
- HTTP status, error.code și pași reproductibili, cu payload redactat.
- Versiunea SDK și Monedo-Version folosite.
- Ce retry-uri ai făcut deja, pentru a evita operații financiare duplicate.