Tranzakció indítása (StartWallet)

Működés

A StartWallet az előzőleg inicializált 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	object / string	a mobiltárcától kapott fizetési token	Apple Pay esetén a teljes event.payment.token objektum vagy annak JSON szövege. Google Pay esetén a paymentData.paymentMethodData.tokenizationData.token változatlan szöveges értéke. A fizetési tokent minden mobiltárcánál 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.

Mintakód

Google Pay indítása mindkét szolgáltatónál:

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"
    }
  }'

Apple Pay esetén a json paraméter tartalma az alábbi szerkezetű. A Token teljes tartalmát a böngészőből kapott tokenre cserélje:

{
  "TransactionId": "992c8e75435e6d4dfdf6415f0714cae8",
  "Wallet": {
    "Token": {
      "paymentData": {
        "version": "EC_v1",
        "data": "ENCRYPTED_PAYMENT_DATA",
        "signature": "SIGNATURE",
        "header": {
          "ephemeralPublicKey": "EPHEMERAL_PUBLIC_KEY",
          "publicKeyHash": "PUBLIC_KEY_HASH",
          "transactionId": "APPLE_TRANSACTION_ID"
        }
      },
      "paymentMethod": {
        "displayName": "Visa 1234",
        "network": "Visa",
        "type": "debit"
      },
      "transactionIdentifier": "APPLE_TRANSACTION_IDENTIFIER"
    }
  }
}

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.
RedirectUrl	string / null	átirányítási URL vagy null	Ha nem üres, irányítsa ide a vásárló böngészőjét. SimplePay hitelesítéshez vagy függő fizetéshez is visszaadható.
ThreeDSAuthClientData	string / null	hitelesítési adat vagy null	Barion Google Pay 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ő Barion Google Pay mintaválasz:

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

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 sikerességét jelzi. A fizetés végleges státuszát 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.