> 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/ismetlodo-fizetes-recurring-payment/nativ-mobiltarca/azonnali-terheles/fizetes-fizetoeszkoez-regisztracioval/tranzakcio-inicializalasa-initwallet.md).

# Tranzakció inicializálása (InitWallet)

### Működés

Az `InitWallet` létrehozza a natív mobiltárcás tranzakciót. A regisztrációs paraméterekkel jelzi, hogy a fizetéshez fizetőeszköz-regisztráció is tartozik. A Google Pay fizetési tokenjét a `StartWallet` kérésben kell átadni.

### **API kérés paraméterek**

#### Az API kérés általános információi

<table data-full-width="true"><thead><tr><th>Művelet</th><th>HTTP kérés</th><th>Adatok</th></tr></thead><tbody><tr><td><code>InitWallet</code></td><td><code>POST</code></td><td>method=<code>InitWallet</code><br><br>json={JSON encode-olt paraméterek}</td></tr></tbody></table>

A kérés a fizetési API végpontjára küldendő. A hitelesítés és az általános paraméterek a [Tranzakció inicializálása (Init) (fizetőeszköz-regisztrációhoz)](/ismetlodo-fizetes-recurring-payment/bankkartya-es-mobiltarca/azonnali-terheles/fizetes-fizetoeszkoez-regisztracioval/tranzakcio-inicializalasa-init-fizetoeszkoez-regisztraciohoz.md) műveletével azonosak. A szolgáltatót `Barion2` néven adja meg. Azonnali terhelésnél az `AutoCommit` elhagyható; a mintában az értéke `"true"`.

{% hint style="info" %}
A natív folyamatban a vásárló nem hagyja el a kereskedő oldalát, kivéve, ha a tranzakció indítására (`StartWallet`) nem üres visszairányítási URL cím (`RedirectUrl`) érkezik. Erre a visszatérésre az `Extra` paraméterben átadott `redirectMode` érték is hatással van, amelyet a [Visszairányítási módok](/segedlet/visszairanyitasi-modok.md) fejezet ismertet.
{% endhint %}

#### **Kötelező paraméterek**

<table data-full-width="true"><thead><tr><th>Paraméter</th><th>Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>ProviderName</code></td><td>string</td><td><code>Barion2</code></td><td>A natív Google Pay regisztrációhoz használt fizetési szolgáltató.</td></tr><tr><td><code>UserId</code></td><td>string<br><br>(255 karakter)</td><td>egyedi értékek<br><br>(kivéve e-mail címek, illetve személyes adatok)</td><td>A vásárló azonosítója a kereskedő rendszerében. A regisztrációt ehhez a vásárlóhoz kell hozzárendelni.</td></tr><tr><td><code>PaymentRegistration</code></td><td>boolean</td><td><code>true</code></td><td>Fizetőeszköz-regisztráció kezdeményezése a fizetéssel együtt.</td></tr><tr><td><code>Wallet.Type</code></td><td>string</td><td><code>google_pay</code></td><td>A natív fizetési mód. Fizetőeszköz-regisztrációt kizárólag Google Pay esetén támogatunk.</td></tr><tr><td><code>Wallet.Environment</code></td><td>string</td><td><code>web</code></td><td>A kliens típusa; teszt- és éles fizetéskor is <code>web</code>.</td></tr><tr><td><code>Wallet.PayerEmailAddress</code></td><td>string</td><td>a vásárló e-mail címe</td><td>Szolgáltatói követelmény: a Barion Google Pay fizetéshez e-mail cím szükséges. Adja át a Google Pay által visszaadott <code>paymentData.email</code> értéket. Rendszerünk a megadott érték formátumát ellenőrzi, a hiányát viszont nem: ha itt nem adja meg, a vásárlás Info adataiból vesszük át a címet. Ha egyik forrásban sincs e-mail cím, a fizetés indítását a <em>Barion</em> utasítja el.</td></tr></tbody></table>

A natív fizetési módot a `Wallet.Type` határozza meg, külön `PaymentMethods` megadása nem szükséges.

{% hint style="warning" %}
A fizetési tokent az inicializálás nem tartalmazhatja. A `Wallet.Token` mező puszta jelenléte `WrongParameter` eredménykódot okoz, üres vagy `null` értékkel is. A tokent a tranzakció indítása (`StartWallet`) adja át, mindkét mobiltárcánál.
{% endhint %}

<table data-full-width="true"><thead><tr><th>Paraméter</th><th>Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>PaymentRegistrationType</code></td><td>string (3 karakter)</td><td><code>MIT</code></td><td>Kereskedő által kezdeményezett későbbi fizetéshez tartozó regisztráció.</td></tr></tbody></table>

Az `Info` mezőben a vásárlói adatok mellett a későbbi fizetések szabályait is adja át. A `Frequency`, `AmountIndicator` és `ExpireDate` mezők használatát és helyét a [MIT regisztráció inicializálása](https://docs.nevogate.com/ismetlodo-fizetes-recurring-payment/bankkartya-es-mobiltarca/azonnali-terheles/fizetes-fizetoeszkoez-regisztracioval/tranzakcio-inicializalasa-init-fizetoeszkoez-regisztraciohoz) és az ahhoz kapcsolódó SCA fejezetek ismertetik. A natív folyamatban ezeket az adatokat az `InitWallet` kérésben kell átadni.

#### **Mintakód**

Az alábbi, a kereskedő szerveréről indított példa azonnali terhelésű MIT típusú regisztrációt mutat. A hitelesítési és rendelési adatokat cserélje saját értékekre, és egészítse ki a kérést a vásárlás [PSD2/SCA adataival](/ismetlodo-fizetes-recurring-payment/bankkartya-es-mobiltarca/azonnali-terheles/fizetes-fizetoeszkoez-regisztracioval/eros-uegyfel-hitelesites-psd2-sca.md). Az `Info` mezőben a későbbi fizetések szabályait is adja át.

{% code overflow="wrap" %}

```bash
curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --user 'sdk_test:86af3-80e4f-f8228-9498f-910ad' \
  --user-agent 'InitWallet | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=InitWallet' \
  --data 'json={
    "StoreName": "sdk_test",
    "ProviderName": "Barion2",
    "ResponseUrl": "https://shop.example.com/payment/response",
    "NotificationUrl": "https://shop.example.com/payment/notification",
    "Amount": 1000,
    "Currency": "HUF",
    "OrderId": "ORDER-123",
    "UserId": "CUSTOMER-123",
    "AutoCommit": "true",
    "PaymentRegistration": true,
    "PaymentRegistrationType": "MIT",
    "Wallet": {
      "Type": "google_pay",
      "Environment": "web",
      "PayerEmailAddress": "customer@example.com"
    }
  }'
```

{% endcode %}

### **API válasz paraméterek**

<table data-full-width="true"><thead><tr><th>Paraméter</th><th>Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>TransactionId</code></td><td>string / null</td><td>egyedi tranzakció azonosító</td><td>A létrehozott tranzakció azonosítója a <em>Nevogate</em> rendszerében. Tárolja a további kérésekhez.</td></tr><tr><td><code>ResultCode</code></td><td>string</td><td><code>SUCCESSFUL</code> vagy hibakód</td><td><code>SUCCESSFUL</code>, vagy a hiba eredménykódja.</td></tr><tr><td><code>ResultMessage</code></td><td>string / null</td><td>szöveges magyarázat vagy null</td><td>Az egyes <code>ResultCode</code> értékek szöveges magyarázata.</td></tr><tr><td><code>ResponseId</code></td><td>integer</td><td>egyedi válaszazonosító</td><td>A válaszüzenet egyedi azonosítója a <em>Nevogate</em> rendszerében.</td></tr></tbody></table>

#### **Mintakód**

Sikeres regisztrációs inicializálás mintaválasza:

{% code overflow="wrap" %}

```php
{
  "TransactionId": "992c8e75435e6d4dfdf6415f0714cae8",
  "ResultCode": "SUCCESSFUL",
  "ResultMessage": null,
  "ResponseId": "3202109280600047703"
}
```

{% endcode %}

Gyakori hibák: `MissingParameter` (hiányzó mobiltárcás vagy regisztrációs adat), `WrongParameter` (hibás típus vagy környezet), `UnauthorizedAccess` (a natív mobiltárcás fizetés nincs engedélyezve a boltban), `WrongProviderSettings` (a Google Pay nincs engedélyezve a szolgáltatónál). Az általános inicializálási és szolgáltatói hibák is előfordulhatnak.