Natív mobiltárca

Ebben a fejezetben a kereskedő saját weboldalába integrált, natív mobiltárcás fizetési megoldások leírását találja.

A natív mobiltárcás fizetés során a vásárló a kereskedő saját weboldalán megjelenített Apple Pay vagy Google Pay gombbal fizet. A kereskedő oldala megnyitja a mobiltárca fizetési felületét, majd a kapott fizetési tokent a kereskedő szerverén keresztül továbbítja rendszerünknek.

A natív mobiltárcás fizetést jelenleg a következő fizetési szolgáltatók támogatják:

• Barion Smart Gateway (Barion2)

• SimplePay (OTPSimple)

A folyamat műveletei a tranzakció inicializálása (InitWallet), a tranzakció indítása (StartWallet), illetve Barion Smart Gateway Google Pay hitelesítés esetén a hitelesítés lezárása (CompleteWallet). A tranzakció eredménye a bankkártyás fizetésből ismert Result kéréssel kérdezhető le.

Az inicializálás (Init) során átadott PaymentMethods paraméter a fizetési szolgáltató fizetőoldalán elérhető fizetési módokat szűri. A kereskedő saját weboldalába integrált mobiltárca esetén az ebben a fejezetben ismertetett műveletek az irányadók.

Bevezetés feltételei

• A natív mobiltárcás fizetést a rendszerünkben, valamint a használni kívánt Apple Pay vagy Google Pay fizetési módot a kiválasztott fizetési szolgáltatónál is külön engedélyezni kell.

• Készítse elő a fizetési szolgáltatónál és a mobiltárcánál szükséges kereskedői és domain beállításokat. A szolgáltatónkénti eltéréseket a SimplePay és a Barion Smart Gateway oldalain részletezzük.

• Integrálja a választott mobiltárca webes kliensét, és ellenőrizze a fizetési mód elérhetőségét a vásárló eszközén. A kereskedő oldali feladatokat a Webes kliens integrációja fejezet ismerteti.

• Készítse el a kereskedő szerverén az API kapcsolatot a hitelesítés és kapcsolódás fejezetben leírtak szerint.

Az API kéréseket a kereskedő szerveréről indítsa. 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.

Fizetési folyamatok

A fizetési folyamat a választott mobiltárcától és fizetési szolgáltatótól függően az alábbiak szerint tér el. A táblázat kizárólag a kereskedő szerveréről indított API műveleteket sorolja fel; a böngészőben futó feladatokat a Webes kliens integrációja fejezet ismerteti.

Fizetési mód	API műveletek	További hitelesítés	Eredmény
SimplePay Apple Pay	InitWallet, StartWallet	Nincs további hitelesítés.	Aszinkron feldolgozás, URL értesítés és Result.
Barion Smart Gateway Apple Pay	InitWallet, StartWallet	Nincs további hitelesítés.	Result.
SimplePay Google Pay	InitWallet, StartWallet	Szükség esetén átirányítás a RedirectUrl címre.	URL értesítés és Result.
Barion Smart Gateway Google Pay	InitWallet, StartWallet, CompleteWallet	ThreeDSAuthClientData esetén webes hitelesítés, majd CompleteWallet.	CompleteWallet válasz és Result.

A folyamatok részletes leírását az Apple Pay fizetési folyamat és a Google Pay fizetési folyamat fejezetekben találja. A kereskedő oldalán, böngészőben futó feladatokat a Webes kliens integrációja fejezet foglalja össze.

Ez a fejezet a webes natív mobiltárcás fizetést ismerteti (Wallet.Environment = web). Az egyszeri fizetés mellett Barion Smart Gateway Google Pay esetén fizetéssel egybekötött kártyaregisztráció is kezdeményezhető. A szükséges paramétereket, a PAN_ONLY feltételt és a későbbi CIT/MIT fizetésekhez kapcsolódást a Fizetés fizetőeszköz-regisztrációval oldal ismerteti.

SimplePay esetén egyik natív mobiltárcás fizetési mód sem használható fizetőeszköz-regisztrációra, Barion Smart Gateway Apple Pay esetén a regisztráció szintén nem támogatott. Kétlépcsős fizetésnél a fizetési szolgáltató feltételeire is figyeljen.

Eredmény és további műveletek

A tranzakció indításának (StartWallet) sikeres végrehajtása önmagában nem igazolja a fizetés sikerességét. Minden URL értesítést követően kérdezze le a tranzakció eredményét, és a rendelést a tranzakció státusza alapján kezelje. Az értesítés a vásárló böngészőben történő visszatérésétől függetlenül is megérkezhet.

A tranzakcióhoz kapcsolódó további műveletek leírását a következő fejezetekben találja:

• URL értesítés

• Tranzakció eredményének lekérdezése (Result)

• Tranzakció részletes adatainak lekérdezése (Details)

• Tranzakció összegének visszatérítése (Refund)

• Kétlépcsős tranzakció lezárása (Close)