Bankkártyás fizetés: miért fontos a hitelesített webhook?

A vásárló fizetett, majd bezárta a böngészőt. Ettől még a rendelésnek fizetettre kell váltania. Az online fizetés ezért nem épülhet kizárólag arra, hogy a vevő visszaérkezik-e egy „sikeres” oldalra. A szolgáltató szerveroldali értesítése, a webhook, ettől független visszajelzési csatorna.

A visszatérési URL nem fizetési bizonyíték

Egy böngészős URL megnyitható, újratölthető vagy elmaradhat. A rendelési státusz módosítását hiteles szolgáltatói eseményhez és az adott integráció dokumentált ellenőrzéséhez kell kötni. Az ellenőrzés módja szolgáltatónként eltér; nem helyettesíthető egy általános, minden fizetési rendszerre ráhúzott megoldással.

Mit ellenőrizzen a feldolgozás?

• Az esemény eredetét, a szolgáltató által előírt hitelesítéssel.
• A megfelelő kereskedői fiókot és a teszt vagy éles környezetet.
• A saját rendeléshez tartozó fizetési azonosítót.
• Az elvárt összeget, pénznemet és az üzletileg megfelelő státuszt.
• Azt, hogy ugyanaz az esemény nem okoz-e ismételt teljesítést.

A Stripe például aláírás-ellenőrzést és az ismételt események kezelését is dokumentálja. Más szolgáltatónál a saját fejlesztői dokumentáció az irányadó. Titkos kulcs nem kerülhet a böngészőbe vagy nyilvános naplóba.

Kétszer érkező értesítésből ne legyen két csomag

Az idempotens feldolgozás azt jelenti, hogy ugyanannak az eseménynek az ismétlése nem hoz létre új üzleti eredményt. A fizetéshez már rögzített esemény ne indítson második számlázást vagy teljesítést. A napló segít tisztázni, mi érkezett be és melyik rendeléshez kapcsolódott.

Ha az értesítés feldolgozása hibás, legyen újrapróbálási és egyeztetési lehetőség. A felület ne jelezzen végleges sikert pusztán attól, hogy a webhook végpont válaszolt. A rendelés és a fizetési tranzakció összekapcsolása visszakereshető állapot legyen.

Mit kérj az átadáskor?

Kérj tesztjegyzőkönyvet sikeres és sikertelen fizetésről, ismételt értesítésről és megszakadt böngészős visszatérésről. A szolgáltatói elszámolás pénzügyi kérdéseit a saját szolgáltatóddal és könyvelőddel szükséges tisztázni.

Technikai háttér: Stripe webhook-dokumentáció. Az ügyféloldali próbához lásd a pénztár tesztelési listáját.