Plăți care nu se fac niciodată de două ori
Un marketplace pentru creatori își plătește creatorii prin Stripe Connect și PayPal. Codul care mută bani se strică altfel decât codul obișnuit: când o cerere expiră, nu știi dacă banii au plecat. Așa l-am construit, astfel încât nicio reîncercare, niciun webhook duplicat și nicio cursă să nu poată plăti pe cineva de două ori.
Proiectul
Un marketplace multi-tenant pentru o agenție de creație din SUA. Brandurile publică oportunități plătite, creatorii livrează conținut, iar o lucrare aprobată devine o plată. Fiecare brand are propria bază de date, iar creatorul alege cum vrea să fie plătit: în cont bancar, prin Stripe Connect, sau prin PayPal. Am proiectat și construit toată platforma ca singur developer.
Ce poate merge prost și ce oprește fiecare situație
Fiecare dintre acestea se întâmplă în realitate. Pentru fiecare există o regulă în cod și un test care o dovedește.
Cineva apasă de două ori pe „Plătește”
Sau doi administratori apasă în același moment. Înainte ca furnizorul să fie apelat, plata este blocată, verificată și salvată ca fiind în procesare. Al doilea clic găsește o plată care nu mai poate fi plătită și este refuzat. Apelul către Stripe sau PayPal se face abia după ce această stare a fost salvată în siguranță.
Cererea expiră: au plecat banii?
Acesta este modul clasic de a plăti de două ori: conexiunea cade, codul presupune un eșec și cineva încearcă din nou. Aici, o cerere rămasă fără răspuns nu este tratată niciodată ca eșec. Plata rămâne în procesare, pentru că banii s-ar putea să fi plecat.
O reîncercare trimite exact aceeași referință ca prima încercare, așa că furnizorul însuși o recunoaște și refuză să plătească din nou. Referința se schimbă doar când furnizorul a spus clar nu.
O confirmare sosește de două ori, prea devreme sau de la o încercare veche
Furnizorii confirmă plățile prin webhook-uri și promit cel puțin o livrare, nu exact una.
- Fiecare webhook este verificat cu semnătura furnizorului înainte să se întâmple ceva
- Procesarea aceleiași confirmări de două ori nu schimbă nimic a doua oară
- O confirmare poate sosi înaintea răspunsului furnizorului la cerere, de aceea plata este salvată mai întâi ca fiind în procesare
- Fiecare confirmare poartă încercarea de care aparține. Veștile despre o încercare mai veche sunt ignorate, așa că un eșec întârziat nu poate anula o plată mai nouă
O confirmare nu mai sosește deloc
Webhook-urile se pierd. Fără o plasă de siguranță, acea plată ar rămâne blocată pentru totdeauna și, până la urmă, cineva ar plăti-o de mână, a doua oară. De aceea, la fiecare zece minute, o verificare programată întreabă direct Stripe și PayPal despre fiecare plată care încă așteaptă și o închide cu răspunsul furnizorului.
Verificarea acoperă și brandurile puse pe pauză sau arhivate, pentru că banii aflați pe drum tot trebuie să ajungă. Un brand cu o problemă nu le blochează niciodată pe celelalte.
Literele mici ale fiecărui furnizor
Cazurile periculoase sunt în detaliile fiecărui furnizor:
- Stripe uită referința unei cereri după 24 de ore. O reîncercare foarte târzie caută mai întâi dacă transferul există deja și nu trimite nimic dacă există
- PayPal răspunde cu o eroare la o cerere repetată. Asta nu este un refuz: plata anterioară există. Codul o găsește și continuă cu ea; dacă ar trata-o ca eșec, s-ar ajunge la o a doua plată
- Banii trimiși prin PayPal la o adresă fără cont așteaptă nerevendicați. Plata este anulată, așa că fondurile se întorc imediat, iar o reîncercare nu poate plăti de două ori când creatorul își face cont mai târziu
- Un transfer care a fost anulat sau care nu corespunde cu suma nu este marcat niciodată ca plătit
Soldul platformei este gol
Aceasta este problema platformei, nu a creatorului. Plata se întoarce în așteptare, cu un mesaj clar pentru administrator să alimenteze soldul. Creatorul nu vede un „eșuat” alarmant pentru ceva care nu are nicio legătură cu el.
Cineva schimbă unde ajung banii
La fiecare schimbare a destinației de plată, creatorul primește un e-mail, ca semnal de alarmă împotriva preluării contului. Linkurile pentru înrolarea contului bancar sunt semnate și de unică folosință și nu se trimit niciodată ca linkuri brute pe e-mail.
Regulile pe care le aplic oricărui cod care mută bani
Nu doar la acest proiect. Orice schimbă bani, credite, stoc sau o stare trece prin această listă.
O singură tranzacție
Scrierile care țin una de alta reușesc sau eșuează împreună. Fără „îl creez, apoi îl șterg la loc dacă pasul doi eșuează”.
Blochez ce citesc
Dacă noua valoare depinde de cea curentă, rândul este blocat și citit din nou înainte de a decide.
Baza de date oprește duplicatele
„A fost deja procesat?” nu este o verificare în cod, ci o cheie unică în baza de date.
Orice reîncercare este sigură
Pornesc de la ideea că fiecare webhook, job și cerere sosește de două ori, târziu sau în ordinea greșită.
Schimbările de stare sunt pași
O plată se poate muta doar pe pași permiși, printr-o singură bucată de cod. Niciodată printr-o atribuire făcută la întâmplare.
O plasă de siguranță în spate
O verificare programată compară evidența noastră cu a furnizorului și rezolvă ce a scăpat.
Code review la preț fix: €950
Nu știți sigur în ce stare este sistemul dumneavoastră sau ce ar presupune un upgrade? Citesc codul și vă spun, în scris, înainte să vă angajați la ceva mai mare.
- Citesc codul și dependențele unei aplicații
- Un raport scris pe înțelesul tuturor: ce este depășit, ce este riscant și ce este în regulă
- Problemele de securitate găsite, ordonate după urgență
- Un plan pas cu pas pentru upgrade sau reparație, cu ofertă la preț fix
- O discuție în care vă explic raportul
Dacă comandați lucrarea din raport, cei €950 se scad din acea factură.
Sistemul dumneavoastră este foarte mare? Atunci vă spun înainte să încep, nu după.