> 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/simplepay/nativ-mobiltarca.md).

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

1. Jelentkezzen be a használni kívánt környezet SimplePay adminisztrációs felületére:
   * teszt (Sandbox): [sandbox.simplepay.hu](https://sandbox.simplepay.hu)
   * éles: [admin.simplepay.hu](https://admin.simplepay.hu)
2. Nyissa meg a megfelelő elfogadóhely beállításait, majd kattintson az **ApplePay** lapfülre.
3. 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-association`
4. Kattintson az **Új domain rögzítése** gombra, és adja hozzá a fizetési oldal domainnevét, például `shop.example.hu`.
5. 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.
6. 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:

| Paraméter                                                | Érték                                                                |
| -------------------------------------------------------- | -------------------------------------------------------------------- |
| `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](https://developers.google.com/pay/api/web/reference/request-objects) 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](/egyszeri-fizetesek-one-time-payment/bankkartya-es-mobiltarca/kesobbi-terheles-ketlepcsos-fizetes/ketlepcsos-tranzakcio-lezarasa-close.md) 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.

* [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)