Natív mobiltárca
A SimplePay natív mobiltárcás integrációjával az Apple Pay és Google Pay gomb a kereskedő saját weboldalán jeleníthető meg. A Nevogate API-ban a ProviderName értéke OTPSimple. A SimplePay Instant Transfer (OTPSimpleWire) szolgáltatás nem támogatja ezeket a műveleteket.
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 SimplePay fizetési szolgáltatónál is külön engedélyezni kell. A szolgáltatói oldali aktiválást, a használni kívánt domaint és a kereskedői adatokat az integráció előtt egyeztesse.
Apple Pay
Domain regisztrációja a SimplePay adminisztrációs felületén
Jelentkezzen be a használni kívánt környezet SimplePay adminisztrációs felületére:
teszt (Sandbox): sandbox.simplepay.hu
éles: admin.simplepay.hu
Nyissa meg a megfelelő elfogadóhely beállításait, majd kattintson az ApplePay lapfülre.
Töltse le az itt elérhető 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-associationKattintson az Új domain rögzítése gombra, és adja hozzá a fizetési oldal domainnevét, például
shop.example.hu.Az oldalon található listában jelölje ki a hozzáadott domaint az előtte lévő jelölőnégyzettel, majd kattintson a Regisztráció gombra.
Ellenőrizze a domain sorában az Állapot oszlopot. A regisztráció akkor sikeres, ha itt a regisztrált felirat jelenik meg.
A domain listához adása önmagában még nem fejezi be a regisztrációt: a kijelölés és a Regisztráció gomb megnyomása is szükséges. 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 a Wallet.ShopUrl a fizetési oldal címét tartalmazza. A Nevogate ebből határozza meg a SimplePay számára átadott domaint. Az inicializálás létrehozza a SimplePay tranzakciót és visszaadja az Apple kereskedői munkamenetet.
Az InitWallet kérésben a Wallet.ValidationUrl is kötelező: ide az Apple onvalidatemerchant eseményéből kapott validationURL értéket adja át. A fizetési token csak a StartWallet kérésben kerül átadásra.
Google Pay
A Google Pay kliens tokenizációs beállításai:
tokenizationSpecification.type
PAYMENT_GATEWAY
tokenizationSpecification.parameters.gateway
simplepay
tokenizationSpecification.parameters.gatewayMerchantId
A fizetéshez kiválasztott SimplePay terminál kereskedői azonosítója.
merchantInfo.merchantId
Éles környezetben a Google által kiadott kereskedői azonosító.
A Google Pay fizetéshez a vásárló e-mail címe szükséges: a Google Pay beállításainál kérje be (emailRequired: true), és a kapott paymentData.email értéket az InitWallet kérés Wallet.PayerEmailAddress mezőjében adja át.
A Google kereskedői azonosító és a SimplePay terminálazonosító külön adat. A Google Pay TEST / PRODUCTION klienskörnyezete a teszt-, illetve éles fizetési környezethez igazodjon; a Nevogate kérésben a Wallet.Environment mindkét esetben web.
A kliensmezők részleteit a Google Pay kérésobjektumok dokumentációja tartalmazza. A támogatott kártyahálózatokat az elfogadói szerződés szerint állítsa be.
Kétlépcsős fizetés
Mindkét natív mobiltárcás ág továbbítja az AutoCommit szerinti végrehajtási módot. Kétlépcsős fizetéshez (AutoCommit = "false") megfelelő SimplePay terminál szükséges. Google Pay esetén már a token létrehozásakor ehhez a terminálhoz tartozó gatewayMerchantId értéket használja; a devizanem és végrehajtási mód a későbbi inicializálással egyezzen.
A SimplePay Google Pay ág kétlépcsős fizetéskor is kezeli a CRYPTOGRAM_3DS hitelesítési módot. A befoglalt összeg terhelését a Close művelettel végezze el.
Hitelesítés és eredmény
Google Pay esetén további hitelesítéshez RedirectUrl érkezhet. A Nevogate válasz ResultCode mezőjének ellenőrzése után a nem üres RedirectUrl címet nyissa meg a vásárló böngészőjében.
Mindkét mobiltárcánál aszinkron eredménykezelésre kell felkészülni. CompleteWallet hívás nem szükséges. A fizetőeszköz-regisztráció egyik SimplePay natív mobiltárcás ágon sem támogatott.
Utoljára frissítve:
Hasznos volt ez?