Google Pay fizetési folyamat (fizetőeszköz-regisztrációhoz)

A fizetési folyamat leírását négy részre bontottuk a könnyebb átláthatóság miatt. Az elválasztás alapját a kereskedő boltjából indított négy fő lépés adja, ezek a lépések a következők:

A. InitWallet - a tranzakció inicializálása fizetőeszköz-regisztrációval B. StartWallet - a fizetési token átadása és a tranzakció indítása C. CompleteWallet - a vásárló hitelesítésének lezárása D. Result - a tranzakció eredményének lekérése rendszerünkből

Az A, B és D lépések együttesen adják ki a vásárló jelenlétében történő fizetési folyamatot, ami a tranzakciós összeg terhelésével és a fizetőeszköz regisztrációjával végződik.

A C lépésre csak akkor kerül sor, ha a tranzakció indítására (StartWallet) kapott válasz hitelesítési adatot (ThreeDSAuthClientData) tartalmaz.

A felsorolt pontok egy sikeres fizetési folyamatot írnak le.

A fizetőeszköz-regisztráció natív mobiltárcával kizárólag Barion Smart Gateway szolgáltatóval és Google Pay fizetéssel lehetséges. A kliens allowedAuthMethods listáját már a fizetési token létrehozásakor kizárólag PAN_ONLY értékre kell szűkíteni.

A. InitWallet - a tranzakció inicializálása fizetőeszköz-regisztrációval

1. A kereskedő oldala a Google Pay elérhetőségének ellenőrzése után megjeleníti a Google Pay gombot a PAN_ONLY hitelesítési móddal és a Barion tokenizációs adataival,

2. ezután a vásárló megnyomja a gombot.

3. A kereskedő oldala megnyitja a Google Pay fizetési felületét, ahol a vásárló kiválasztja a fizetőeszközt és jóváhagyja a fizetést.

4. A kereskedő oldala elküldi a kereskedő szerverének a Google Pay fizetési tokent (paymentData.paymentMethodData.tokenizationData.token) és a vásárló e-mail címét.

5. A kereskedő szervere új mobiltárcás fizetési tranzakciót kezdeményez rendszerünkben a regisztrációs paraméterek átadásával (InitWallet).

6. Rendszerünk hitelesíti a beérkezett kérést (autentikáció),

7. ezután rendszerünk egy egyedi tranzakció azonosítót (TransactionId) küld vissza a kereskedő szerverének (sikeres hitelesítés esetén).

8. A kereskedő szervere tárolja az egyedi tranzakció azonosítót a vásárlóhoz és a rendeléshez rendelve.

Az inicializálás során a natív fizetési módot a Wallet.Type paraméter (google_pay), a kliens típusát pedig a Wallet.Environment paraméter (web) jelöli. A fizetőeszköz-regisztrációt a PaymentRegistration, a PaymentRegistrationType (MIT) és az egyedi UserId paraméter kéri. Az AutoCommit paraméter értéke true.

Az inicializálásra és a tranzakció indítására a kereskedő szerver oldalán kerüljön sor. Biztonsági okokból a hitelesítési adatok nem kerülhetnek a böngészőbe, a rendelés összegét, devizanemét és a kiválasztott fizetési szolgáltatót pedig szerver oldalon ellenőrizze.

B. StartWallet - a fizetési token átadása és a tranzakció indítása

1. A kereskedő szervere a tárolt tranzakció azonosítóval és a fizetési tokennel (Wallet.Token) elindítja a tranzakciót rendszerünkben (StartWallet).

2. Rendszerünk ellenőrzi a tranzakció azonosítót és a kapott fizetési tokennel elindítja a fizetést és a fizetőeszköz regisztrációját a fizetési szolgáltatónál (sikeres ellenőrzés esetén),

3. ezután rendszerünk megválaszolja a tranzakció indításának eredményét a kereskedő szerverének.

4. A kereskedő szervere az eredményt visszaadja a kereskedő oldalának.

5. Ha a válasz nem üres hitelesítési adatot (ThreeDSAuthClientData) tartalmaz, a fizetés a C. lépéssel folytatódik.

6. Rendszerünk a tranzakció státuszának beállítását követően aszinkron módon meghívja az inicializáció (InitWallet) során átadott NotificationUrl címet is.

A tranzakció indításakor a fizetési tokent a Wallet.Token paraméterben kell átadni. A regisztrációs paramétereket nem kell újra megadni, azokat rendszerünk az inicializálás során kapott adatokból veszi.

C. CompleteWallet - a vásárló hitelesítésének lezárása

1. A kereskedő oldala átadja a kapott hitelesítési adatot (ThreeDSAuthClientData) a Barion Smart Gateway webes hitelesítő kliensének, amely elvégzi a vásárló hitelesítését,

2. ezután a kereskedő oldala értesíti a kereskedő szerverét a hitelesítés befejeződéséről.

3. A kereskedő szervere a tranzakció azonosítójával jelzi rendszerünknek, hogy a hitelesítés lezárult (CompleteWallet). A kérés a hitelesítés kimenetelétől függetlenül kizárólag a tranzakció azonosítóját tartalmazza: a hitelesítés eredményét rendszerünk a fizetési szolgáltatótól kérdezi le.

4. Rendszerünk lezárja a fizetést a fizetési szolgáltatónál, majd beállítja a tranzakció státuszát a fizetési szolgáltató válasza alapján,

5. ezután rendszerünk megválaszolja a tranzakció státuszát a kereskedő szerverének.

6. A kereskedő szervere a kapott státusz alapján tájékoztatja a kereskedő oldalát a hitelesítés és a fizetés eredményéről.

A C.1. lépésben leírt hitelesítés a Barion Smart Gateway webes hitelesítő kliensének authenticate() függvényével történik. A rendelés állapotát ne kizárólag a böngészőben kapott sikeres hitelesítési esemény alapján állítsa be, hanem a tranzakció státusza alapján.

D. Result - a tranzakció eredményének lekérése rendszerünkből

1. A kereskedő szervere a ResponseUrl és NotificationUrl hívás hatására egy tranzakció azonosítót tartalmazó Result kéréssel lekérdezi a tranzakció eredményét rendszerünkből.

2. Rendszerünk ellenőrzi a tranzakció azonosítót,

3. ezután rendszerünk megválaszolja a tranzakció státuszát a kereskedő szerverének (sikeres ellenőrzés esetén).

4. A kereskedő szervere tárolja a tranzakció státuszát és a regisztráció létrejöttét, majd a kereskedő oldala értesíti a vásárlót a tranzakció eredményéről.

Figyeljen arra, hogy minden NotificationUrl hívást követően is indítson egy Result kérést rendszerünk felé. Az inicializálás vagy a tranzakció indítása során kapott SUCCESSFUL eredménykód a kérés sikeres feldolgozását jelzi, nem a fizetés és a regisztráció sikerességét.