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

Művelet	HTTP kérés	Adatok
InitWallet	POST	method=InitWallet json={JSON encode-olt paraméterek}

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) műveletével azonosak. A szolgáltatót Barion2 néven adja meg. Kétlépcsős fizetéshez az AutoCommit értéke "false".

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 fejezet ismertet.

Kötelező paraméterek

Paraméter	Típus	Érték	Leírás
ProviderName	string	Barion2	A natív Google Pay regisztrációhoz használt fizetési szolgáltató.
UserId	string (255 karakter)	egyedi értékek (kivéve e-mail címek, illetve személyes adatok)	A vásárló azonosítója a kereskedő rendszerében. A regisztrációt ehhez a vásárlóhoz kell hozzárendelni.
PaymentRegistration	boolean	true	Fizetőeszköz-regisztráció kezdeményezése a fizetéssel együtt.
Wallet.Type	string	google_pay	A natív fizetési mód. Fizetőeszköz-regisztrációt kizárólag Google Pay esetén támogatunk.
Wallet.Environment	string	web	A kliens típusa; teszt- és éles fizetéskor is web.
Wallet.PayerEmailAddress	string	a vásárló e-mail címe	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 paymentData.email é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 Barion utasítja el.

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

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.

Paraméter	Típus	Érték	Leírás
PaymentRegistrationType	string (3 karakter)	CIT	Vásárló által kezdeményezett későbbi egykattintásos fizetéshez tartozó regisztráció.

A regisztráció létrehozásakor a OneClickPayment és ReferenceTransactionId mezőket hagyja el. Ezek a már regisztrált fizetőeszközzel kezdeményezett, későbbi CIT fizetéshez tartoznak.

Mintakód

Az alábbi, a kereskedő szerveréről indított példa kétlépcsős CIT 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.

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": "false",
    "PaymentRegistration": true,
    "PaymentRegistrationType": "CIT",
    "Wallet": {
      "Type": "google_pay",
      "Environment": "web",
      "PayerEmailAddress": "[e-mail]"
    }
  }'

API válasz paraméterek

Paraméter	Típus	Érték	Leírás
TransactionId	string / null	egyedi tranzakció azonosító	A létrehozott tranzakció azonosítója a Nevogate rendszerében. Tárolja a további kérésekhez.
ResultCode	string	SUCCESSFUL vagy hibakód	SUCCESSFUL, vagy a hiba eredménykódja.
ResultMessage	string / null	szöveges magyarázat vagy null	Az egyes ResultCode értékek szöveges magyarázata.
ResponseId	integer	egyedi válaszazonosító	A válaszüzenet egyedi azonosítója a Nevogate rendszerében.

Mintakód

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

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

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.