Google Pay fizetési folyamat

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 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 teljes fizetési folyamatot.

A C lépésre kizárólag Barion Smart Gateway esetén, és csak akkor kerül sor, ha a tranzakció indítására (StartWallet) kapott válasz hitelesítési adatot (ThreeDSAuthClientData) tartalmaz. SimplePay esetén ez a lépés nem része a folyamatnak.

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

Barion Smart Gateway esetén a fizetés fizetőeszköz-regisztrációval is összekapcsolható. Ehhez már a fizetési token létrehozása előtt PAN_ONLY kliensbeállítás szükséges, az inicializálás (InitWallet) pedig regisztrációs paraméterekkel egészül ki. A folyamatot a Fizetés fizetőeszköz-regisztrációval fejezet ismerteti.

A. InitWallet - a tranzakció inicializálása

1. A kereskedő oldala a Google Pay elérhetőségének ellenőrzése után megjeleníti a Google Pay gombot a kiválasztott fizetési szolgáltatóhoz tartozó tokenizációs adatokkal,

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 (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őnek (sikeres hitelesítés esetén).

8. A kereskedő szervere tárolja az egyedi tranzakció azonosítót.

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 vásárló e-mail címét (Wallet.PayerEmailAddress) Barion Smart Gateway esetén kötelező átadni.

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 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 a tranzakció indításának eredményét visszaadja a kereskedő oldalának.

5. Ha a válasz nem üres visszairányítási URL címet (RedirectUrl) tartalmaz, a kereskedő oldala erre a címre irányítja a vásárló böngészőjét (SimplePay esetén). A vásárló a hitelesítést vagy a függőben lévő fizetés feldolgozását követően rendszerünkön keresztül tér vissza a kereskedő oldalára.

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

7. Rendszerünk a tranzakció végstá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; az inicializálás nem tartalmazhatja.

Google Pay fizetés esetén a fizetési token már a vásárlói jóváhagyáskor létrejön, ezért a folyamat nem tartalmaz kereskedői munkamenet-hitelesítést. A fizetési tokent változatlan szöveges formában továbbítsa, a fizetési szolgáltató felé szükséges Base64-kódolást rendszerünk végzi el.

A tranzakció indítására kapott SUCCESSFUL eredménykód a kérés sikeres feldolgozását jelzi, nem a rendelés kifizetettségét. Már elindított tranzakcióra ne ismételje meg automatikusan a StartWallet kérést.

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ó végleges 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, 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é.

Ismeretlen kimenetelű hálózati hiba után előbb a meglévő tranzakció eredményét kérdezze le, és ne indítson automatikusan újabb terhelést.