> For the complete documentation index, see [llms.txt](https://docs.nevogate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nevogate.com/segedlet/fizetesi-szolgaltato-specifikus-adatok/barion-smart-gateway/nativ-mobiltarca.md).

# 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**

1. Jelentkezzen be a használni kívánt környezet Barion adminisztrációs felületére:
   * teszt (Sandbox): [secure.test.barion.com](https://secure.test.barion.com)
   * éles: [secure.barion.com](https://secure.barion.com)
2. A bal oldali menüben válassza az **Elfogadóhelyek** menüpontot.
3. A megfelelő elfogadóhely sorában kattintson a **három pontra**, majd válassza a **Beállítások** lehetőséget.
4. A megjelenő oldalon kattintson az **ApplePay beállítások** gombra.
5. 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-association`
6. A 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

| Paraméter                                                | Érték                                                                    |
| -------------------------------------------------------- | ------------------------------------------------------------------------ |
| `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](https://docs.barion.com/Payment-StartPaymentWithGoogleToken-v3) 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ó](https://docs.barion.com/Google_Pay) 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](/egykattintasos-fizetes-one-click-payment/nativ-mobiltarca/azonnali-terheles/fizetes-fizetoeszkoez-regisztracioval.md) 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](https://docs.barion.com/Token_payment_3D_Secure#Off-site_3DS_v2_authentication) 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.

* [Natív mobiltárcás fizetés áttekintése](/egyszeri-fizetesek-one-time-payment/nativ-mobiltarca.md)
* [Apple Pay fizetési folyamat](/egyszeri-fizetesek-one-time-payment/nativ-mobiltarca/azonnali-terheles/apple-pay-fizetesi-folyamat.md)
* [Google Pay fizetési folyamat](/egyszeri-fizetesek-one-time-payment/nativ-mobiltarca/azonnali-terheles/google-pay-fizetesi-folyamat.md)
* [Webes kliens integrációja](/egyszeri-fizetesek-one-time-payment/nativ-mobiltarca/azonnali-terheles/webes-kliens-integracioja.md)