Natív mobiltárca
A Barion Smart Gateway natív mobiltárcás integrációjával az Apple Pay és Google Pay a kereskedő saját weboldalán használható. A Nevogate API-ban a ProviderName értéke Barion2.
Bevezetés és beállítások
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 Barion fizetési szolgáltatónál is külön engedélyezni kell. A szolgáltatói és domainbeállításokat a bevezetés előtt egyeztesse.
Apple Pay
Domain regisztrációja a Barion adminisztrációs felületén
Jelentkezzen be a használni kívánt környezet Barion adminisztrációs felületére:
teszt (Sandbox): secure.test.barion.com
éles: secure.barion.com
A bal oldali menüben válassza az Elfogadóhelyek menüpontot.
A megfelelő elfogadóhely sorában kattintson a három pontra, majd válassza a Beállítások lehetőséget.
A megjelenő oldalon kattintson az ApplePay beállítások gombra.
Töltse le a Domain ellenőrző fájlt, és helyezze el a fizetési weboldal
/.well-known/könyvtárában, az eredeti fájlnévvel. A fájl az alábbi címen legyen elérhető:https://shop.example.hu/.well-known/apple-developer-merchantid-domain-associationA letöltési lehetőség alatti mezőben adja meg a fizetési oldal domainnevét, például
shop.example.hu.
A megadott domain a fizetési oldalhoz és az InitWallet kérésben átadott Wallet.ShopUrl címhez tartozzon.
Fizetési munkamenet
Az InitWallet kérésben kötelező a Wallet.ShopUrl és az Apple onvalidatemerchant eseményéből kapott Wallet.ValidationUrl. A Wallet.ShopUrl értékét változatlan formában továbbítjuk a Barionnak, ezért itt a fizetési oldal teljes https:// kezdetű címét adja át. A válaszban kapott Apple Pay merchant session objektumot változtatás nélkül adja át a böngésző completeMerchantValidation(...) hívásának.
Az inicializálás a kereskedői munkamenetet hitelesíti; a Barion fizetési tranzakció a StartWallet híváskor keletkezik. A teljes Apple Pay tokent ekkor kell átadni. A számlázási és szállítási adatokat a szokásos Info (PSD2/SCA) struktúrában küldje.
Apple Pay esetén nincs külön CompleteWallet lépés, és fizetőeszköz-regisztráció nem támogatott.
Google Pay
tokenizationSpecification.type
PAYMENT_GATEWAY
tokenizationSpecification.parameters.gateway
barion
tokenizationSpecification.parameters.gatewayMerchantId
A Barion bolt nyilvános POS azonosítója (POS GUID).
merchantInfo.merchantId
A Google által kiadott kereskedői azonosító az éles webes integrációhoz.
A POS GUID a tokenizációhoz használt azonosító; a titkos Barion POS kulcsot ne tegye a böngészőbe. A Google Pay beállításainál kérje be a vásárló e-mail címét (emailRequired: true), és a kapott paymentData.email értéket az InitWallet kérés Wallet.PayerEmailAddress mezőjében adja át. A Barion Google Pay API ezt az adatot megköveteli.
Azonnali, egyszeri fizetésnél PAN_ONLY és CRYPTOGRAM_3DS használható. Kétlépcsős Google Pay fizetésnél (AutoCommit = "false"), fizetőeszköz-regisztrációnál és referencia-fizetésnél a kliens allowedAuthMethods listáját kizárólag PAN_ONLY értékre kell szűkíteni. A regisztrációra és referencia-fizetésre vonatkozó korlátozás azonnali terhelés esetén is érvényes. A részletes kliensfeltételeket, köztük a számlázási cím beállítását a Barion Google Pay útmutató tartalmazza.
Fizetőeszköz-regisztráció Google Pay-jel
A natív Google Pay fizetés kártyaregisztrációval is összekapcsolható. Az InitWallet kérésben PaymentRegistration = true, PaymentRegistrationType = CIT vagy MIT, valamint egyedi UserId szükséges. A regisztráció használatát a bolt Barion kapcsolatánál is engedélyezni kell. A folyamatot és a mintakódot a Fizetés fizetőeszköz-regisztrációval oldal tartalmazza.
Google Pay ügyfél-hitelesítés
A StartWallet nem üres ThreeDSAuthClientData válaszmezője további webes hitelesítést jelez. Végezze el a hitelesítést a Barion Smart Gateway webes hitelesítő kliensével, majd a kereskedő szerveréről hívja a CompleteWallet műveletet. A CompleteWallet 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 Barion Smart Gateway-től kérdezi le, sikertelen hitelesítésnél pedig hibás eredménykódot ad vissza. A hitelesítést végző authenticate() függvény használatát a Barion Off-site hitelesítés leírása ismerteti.
A teljes fizetés eredményét a Result művelettel és az URL értesítések feldolgozásával ellenőrizze.
Utoljára frissítve:
Hasznos volt ez?