Tranzakció indítása (StartWallet)

Működés

A StartWallet az előzőleg inicializált, fizetőeszköz-regisztrációval egybekötött mobiltárcás tranzakció fizetését indítja el. A művelet hitelesített API kérés, amelyet a kereskedő szerveréről kell indítani.

API kérés paraméterek

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

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

Kötelező paraméterek

Paraméter	Típus	Érték	Leírás
TransactionId	string	az InitWallet válaszban kapott azonosító	Az előzőleg inicializált mobiltárcás tranzakció azonosítója.
Wallet.Token	string	a Google Pay által kiadott fizetési token	A paymentData.paymentMethodData.tokenizationData.token változatlan szöveges értéke. A fizetési tokent ez a kérés adja át, az inicializálás nem tartalmazhatja.

A Wallet objektum a fizetési tokenen kívül más mezőt nem tartalmaz. A fizetési módot (Wallet.Type) és a kliens típusát (Wallet.Environment) a tranzakcióból oldjuk fel, a vásárló e-mail címét (Wallet.PayerEmailAddress) pedig az inicializáláskor kell átadni — ezeket a tranzakció indításakor ne ismételje meg. A regisztrációs paramétereket sem kell megismételni, azokat rendszerünk az inicializálás során kapott adatokból veszi.

Mintakód

curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --user 'sdk_test:86af3-80e4f-f8228-9498f-910ad' \
  --user-agent 'StartWallet | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=StartWallet' \
  --data 'json={
    "TransactionId": "992c8e75435e6d4dfdf6415f0714cae8",
    "Wallet": {
      "Token": "GOOGLE_PAY_TOKEN_FROM_BROWSER"
    }
  }'

API válasz paraméterek

Paraméter	Típus	Érték	Leírás
TransactionId	string	egyedi tranzakció azonosító	A tranzakció azonosítója a Nevogate rendszerében.
ResultCode	string	SUCCESSFUL vagy hibakód	A művelet eredménye: SUCCESSFUL vagy hibakód.
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.
ThreeDSAuthClientData	string / null	hitelesítési adat vagy null	A Barion Smart Gateway további hitelesítésének adata. Nem üres értéknél a webes hitelesítés után CompleteWallet szükséges.

Mintakód

Hitelesítést igénylő mintaválasz:

{
  "TransactionId": "992c8e75435e6d4dfdf6415f0714cae8",
  "ResultCode": "SUCCESSFUL",
  "ResultMessage": null,
  "ResponseId": "3202109280600047704",
  "ThreeDSAuthClientData": "BARION_AUTHENTICATION_DATA"
}

Gyakori hibák: WrongTransactionStatus (a tranzakció nincs elindítható állapotban: már elindították, hibás státuszba került, vagy lejárt), MissingParameter és WrongParameter (hiányzó vagy hibás fizetési token), WrongProviderSettings (a mobiltárca nincs engedélyezve a szolgáltatónál). Az általános és szolgáltatói hibakódok is előfordulhatnak.

A SUCCESSFUL itt a fizetésindítás műveletének eredménye, nem a fizetés és a fizetőeszköz-regisztráció sikerességét jelzi. A végleges státuszt Result kéréssel ellenőrizze. Már elindított tranzakcióra ne ismételje meg a StartWallet hívást: a válasz WrongTransactionStatus eredménykód lesz. Ismeretlen kimenetelű hálózati hiba után előbb a tranzakció eredményét kérdezze le (Result), és csak annak alapján döntsön.

Paraméterhiba (MissingParameter, WrongParameter) esetén a tranzakció elindítható állapotban marad, ezért a StartWallet kérés javított adatokkal megismételhető. Ha viszont a fizetési szolgáltató hívása hiúsul meg, a tranzakció hibás státuszba kerül: ilyenkor új tranzakciót kell inicializálni (InitWallet), és a mobiltárcától új fizetési tokent kell kérni.