OrsunPay logotipsOrsunPay
LatviešuLatviešu
Kontakti

Maksājumu webhook: pārbaude, dublikāti un atkopšana

Webhook ļauj maksājumu sistēmai paziņot lietotnei par notikumu arī tad, ja klients vairs neatrodas apmaksas lapā. Taču saņemta HTTP ziņa pati par sevi nedod tiesības izpildīt pasūtījumu. Jāpārbauda tās izcelsme, jāatrod pareizā transakcija un jānovērš atkārtots biznesa efekts. Šis ceļvedis aplūko tieši saņēmēja darbu un atkopšanu. Tas papildina API izveides procesu, koncentrējoties uz to, kas notiek pēc sākotnējā pieprasījuma un kā komanda saglabā skaidrību par jau apstrādātiem notikumiem.

OrsunPay komandaPublicēts
Raksta ilustrācija: Maksājumu webhook: pārbaude, dublikāti un atkopšana

Nosakiet, ko paziņojums drīkst mainīt

Pirms endpoint izveides uzrakstiet, kādu lēmumu atbalsta katrs dokumentētais notikums. Ziņa var sniegt informāciju par transakciju, bet jūsu lietotnei joprojām jāzina, kuram pasūtījumam tā pieder. Saglabājiet šo saikni no sākotnējās izveides. Neļaujiet ienākošam laukam bez pārbaudes izvēlēties citu veikalu vai brīvi pārrakstīt pasūtījumu. Ja atsauce nav atrodama, gadījums jāizmeklē. Skaidri ierobežots efekts palīdz novērst situāciju, kad tehniski saņemts ziņojums tiek uztverts kā universāla komanda jebkurai biznesa darbībai, ko lietotne var veikt.

Parakstīti maksājumu paziņojumi

Pārbaudiet parakstu pār sākotnējiem datiem

OrsunPay dokumentē HMAC-SHA256 parakstu pār neizmainītiem pieprasījuma satura baitiem. Tāpēc saņemšanas slānim jāsaglabā tieši pārbaudei nepieciešamais saturs pirms pārformatēšanas vai atkārtotas serializācijas. Slepenās atslēgas jāglabā servera pusē un tās nedrīkst nonākt pārlūka kodā vai brīvi lasāmos žurnālos. Nekorekts paraksts nedrīkst atjaunināt pasūtījumu. Stripe dokumentācija arī izskaidro parakstu pārbaudes nozīmi. Izmantojiet konkrētās integrācijas instrukcijas, jo cita sniedzēja piemērs nav automātiski tas pats paraksta formāts vai tā pati apstrādes secība.

Maksājumu API izstrādātājiem

Reģistrējiet notikumu un izpildiet efektu vienreiz

Tā pati informācija var pienākt atkārtoti, un lietotnei tas jāpārdzīvo bez otras piegādes. Izveidojiet skaidru veidu, kā atpazīt jau apstrādātu notikumu vai jau piemērotu biznesa rezultātu saskaņā ar dokumentēto datu modeli. Reģistrēšana un pasūtījuma pāreja jāprojektē kopā, lai kļūme starp šiem soļiem neradītu neievērotu dublikātu. Nemainiet katru saņemtu ziņu par jaunu pārdošanu. Atkārtota saņemšana var būt normāla atkopšanas daļa. Komandai jāredz, ka notikums saņemts vēlreiz, bet pasūtījuma biznesa darbība jau veikta un nav jāatkārto.

Apstrādājiet novēlotu informāciju saprotami

Klients var jau būt aizvēris pārlūku, kad tiek saņemts derīgs rezultāts. Tāpēc pasūtījuma stāvoklis nedrīkst būt atkarīgs tikai no atgriešanās lapas. Mollie un Stripe dokumentācijā servera paziņojumi papildina šo redzamo ceļu. Definējiet, kā lietotne izmanto novēlotu notikumu un kā pārbauda pašreizējo statusu, ja vajadzīgs. Nepieņemiet sev vēlamu ziņojumu secību bez konkrētas garantijas dokumentācijā. Katram stāvoklim jābūt atļautām pārejām un izmeklēšanas ceļam, lai veca vai neskaidra informācija nepārrakstītu jau pamatotu lēmumu nepārdomātā veidā.

Padariet atkopšanu ierobežotu un pārskatāmu

OrsunPay izmanto parakstītus paziņojumus un ierobežotus atkārtotas piegādes mēģinājumus. Lietotnes uztvērējam jābūt gatavam kļūmēm, taču nedrīkst balstīt atkopšanu uz pieņēmumu par bezgalīgu atkārtošanu. Norādiet, kā konstatē nesaņemtu vai neapstrādātu rezultātu un kurš drīkst sākt pārbaudi. Ja atkārto iekšēju apstrādi, tā nav automātiski jauna maksājuma izveide. Darbiniekam jāredz atšķirība. Saglabājiet pietiekamu diagnostikas informāciju ar ierobežotu piekļuvi, izvairoties no nevajadzīgiem sensitīviem datiem. Atkopšanas mērķis ir pareizs pasūtījuma rezultāts, nevis tikai veiksmīgs tehniskā izsaukuma statuss.

Pārbaudiet saņēmēju pirms nodošanas

Pieņemšanā iekļaujiet nederīgu parakstu, atkārtotu ziņojumu, novēlotu apstiprinājumu un kļūmi biznesa darbības laikā. Katram gadījumam nosakiet sagaidāmo pasūtījuma stāvokli. Pieejamie paziņojumu žurnāli un to tiesības ir tehniska darba rīki, nevis pilnīga PSP norēķinu vai grāmatvedības uzskaite. OrsunPay savieno jūsu kontus, bet līdzekļu apstrāde un norēķini paliek PSP atbildībā saskaņā ar līgumu. Pārskatāma nodošana ļauj atbalstam un izstrādei vienādi izskaidrot, kas saņemts, kas pārbaudīts un kāda darbība patiešām jau izpildīta.

  • Nederīgs paraksts nedrīkst mainīt pasūtījumu.
  • Dublikāts nedrīkst radīt otro biznesa darbību.
  • Novēlotu rezultātu piesaistiet sākotnējai transakcijai.
  • Atšķiriet paziņojuma atkopšanu no jauna maksājuma.
  • Pārbaudiet žurnālu piekļuvi un diagnostikas saturu.

Saistītie produkti

Sazinieties ar mums

Avoti

Saistītie raksti