Baza de cunoștințe
Întrebări despre E-commerce — Plăți și rambursări
Răspunsuri documentate despre E-commerce — Plăți și rambursări. Consultă explicațiile, pașii de verificare și sursele pentru fiecare întrebare.
Răspunsuri documentate
Când folosesc autorizare și captură în doi pași?
Acest flux poate fi potrivit când trebuie să confirmi stocul sau pregătirea înainte de încasarea efectivă, dar autorizările expiră după o perioadă stabilită de procesator. Confirmă perioada și metoda de captură suportată și asigură o alertă pentru plățile autorizate încă necapturate.
Surse: Shopify Help Center — Capturing payments for orders · Stripe Docs — Payment Intents API
Clientul a închis pagina procesatorului înainte să revină în magazin. Cum aflu dacă plata a reușit?
Pagina de întoarcere nu este singura sursă de adevăr. Consultă dashboardul procesatorului și evenimentele webhook pentru tranzacția referită de coș; metodele cu redirect pot continua sau eșua asincron.
Surse: Shopify Help Center — Troubleshooting checkout payment issues · Stripe Docs — Receive events in your webhook endpoint · PayPal Developer — Webhooks overview
Pot confirma comanda doar din pagina „success” din browser?
Nu este robust să pornești livrarea exclusiv de la redirectul clientului, care poate lipsi sau fi falsificat. Confirmă starea server-side prin API-ul procesatorului și evenimentul webhook semnat, apoi actualizează comanda idempotent.
Surse: Stripe Docs — Receive events in your webhook endpoint · PayPal Developer — Integrate webhooks
De ce primesc același eveniment de plată de mai multe ori?
Webhookurile pot fi retrimise când endpointul nu confirmă la timp sau există o eroare de rețea. Păstrează identificatorul evenimentului/delivery-ului procesat și fă handlerul idempotent, astfel încât o livrare repetată să nu creeze încă o expediere sau rambursare.
Surse: Shopify Developer — Verify webhook deliveries · PayPal Developer — Webhooks overview · Stripe Docs — Receive events in your webhook endpoint
Ce se întâmplă dacă endpointul meu webhook returnează 500?
Procesatorul poate considera livrarea eșuată și o poate încerca din nou conform politicii sale. Răspunde rapid cu succes după ce ai înregistrat durabil evenimentul, iar procesarea lentă mut-o într-o coadă; monitorizează retries și recuperarea evenimentelor ratate.
Surse: Shopify Developer — Troubleshoot webhooks · PayPal Developer — Integrate webhooks · Stripe Docs — Receive events in your webhook endpoint
Cum verific dacă notificarea webhook chiar vine de la procesator?
Validează semnătura folosind corpul brut al cererii și secretul configurat sau endpointul oficial de verificare al procesatorului. Nu procesa modificări de plată pe baza unei cereri publice nesemnate, chiar dacă payloadul pare valid.
Surse: Shopify Developer — Verify webhook deliveries · PayPal Developer — Webhooks overview · Stripe Docs — Receive events in your webhook endpoint
Ce ar trebui să facă endpointul webhook înainte să răspundă 2xx?
Verifică semnătura, salvează evenimentul într-un jurnal sau coadă durabilă și apoi confirmă recepția. Evită să trimiți e-mailuri, să generezi documente și să chemi multe API-uri înainte de răspuns, deoarece timeoutul poate provoca re-livrări.
Surse: Stripe Docs — Receive events in your webhook endpoint · PayPal Developer — Integrate webhooks
Cum previn două debitări când clientul apasă de două ori pe butonul de plată?
Folosește identificatorul unic al coșului sau încercării de plată pentru o cheie de idempotency pe server, iar interfața blochează temporar acțiunile repetate. După timeout, verifică statusul primei cereri înainte să inițiezi o tranzacție nouă.
Surse: Stripe Docs — Idempotent requests · PayPal Developer — Making REST API requests
API-ul procesatorului a dat timeout. Pot repeta imediat cererea?
Mai întâi verifică dacă prima operațiune a fost înregistrată; lipsa răspunsului nu înseamnă că a eșuat. Repetă cu aceeași cheie de idempotency dacă endpointul suportă mecanismul și aceiași parametri, apoi reconciliază tranzacția.
Surse: Stripe Docs — Idempotent requests · PayPal Developer — Making REST API requests
Ce înseamnă „requires action” la o plată?
Plata așteaptă un pas suplimentar, de exemplu autentificare sau redirect, înainte de rezultat final. Lasă fluxul clientului să finalizeze acțiunea și confirmă starea finală prin API/webhook înainte de fulfillment.
Surse: Stripe Docs — Payment Intents API · Shopify Help Center — Troubleshooting checkout payment issues
O plată în stare „processing” este sigură pentru expediere?
Nu presupune că processing este același lucru cu succeeded; unele metode au decontare asincronă și pot eșua ulterior. Configurează comenzile să aștepte evenimentul final și explică starea intermediară în interfața clientului.
Surse: Stripe Docs — Payment Intents API · Stripe Docs — Receive events in your webhook endpoint · PayPal Developer — Webhooks overview
Pot captura plata în tranșe pentru expedieri separate?
Suportul pentru capturi multiple depinde de procesator, metoda de plată și configurarea contului. Confirmă limita și suma autorizată înainte să proiectezi fluxul de expediere parțială și testează evidența fiecărei capturi în comandă.
Surse: Shopify Help Center — Capturing payments for orders · PayPal Developer — Orders v2
De ce rambursarea apare pending, nu completed?
Refundul poate aștepta disponibilitatea soldului procesatorului sau confirmarea băncii, în funcție de metodă. Urmărește starea refundului în dashboard și nu iniția o a doua rambursare până nu verifici rezultatul primei solicitări.
Pot trimite rambursarea pe alt card decât cel folosit la plată?
Multe procesatoare trimit refundul numai către metoda inițială, iar emitentul cardului gestionează cardurile expirate sau înlocuite. Verifică instrucțiunile metodei și păstrează dovada tranzacției în registrul comenzii.
Surse: Stripe Docs — Refund and cancel payments · Shopify Help Center — Refunding orders
Cum sincronizez o rambursare parțială cu totalul comenzii?
Înregistrează refundul în procesator și actualizează suma rambursată și liniile afectate în platforma magazinului. Verifică dacă taxa de livrare, taxele sau cantitatea restocată sunt incluse separat, fără a presupune că statusul general surprinde toate detaliile.
Surse: Stripe Docs — Refund and cancel payments · Shopify Help Center — Refunding orders
Rambursarea trebuie să restocheze automat articolele?
Nu obligatoriu: banii returnați nu dovedesc că bunul a fost recepționat ori poate fi revândut. Ține separat operațiunea financiară, returul fizic și ajustarea de inventar.
Surse: Stripe Docs — Refund and cancel payments · Shopify Help Center — Returns and exchanges · Shopify Help Center — Adjusting inventory quantities
De ce plata și totalul comenzii apar în monede diferite?
Verifică moneda de prezentare, moneda efectivă a tranzacției și eventualul schimb aplicat de procesator sau bancă. Păstrează moneda originală și referința plății în comandă pentru reconcilierea payoutului.
Surse: Shopify Help Center — Managing orders · Stripe Docs — Payment Intents API
De ce suma payoutului către bancă nu este egală cu valoarea comenzilor plătite?
Payouturile pot agrega tranzacții și pot reflecta refunduri, comisioane, conversii valutare și intervale diferite de decontare. Compară fiecare referință de plată cu raportul payout și nu reconcilia numai prin totalul zilnic.
Surse: PayPal Developer — Orders v2 · Stripe Docs — Receive events in your webhook endpoint
Poate clientul contesta o plată după ce i-am făcut refund parțial?
Da, iar contestarea poate privi suma integrală în funcție de proces și de rețeaua de plată. Păstrează dovada refundului și comunicarea relevantă, apoi urmărește termenele și instrucțiunile platformei de plăți.
Surse: Shopify Help Center — Refunding orders · Stripe Docs — Refund and cancel payments