Tranzakció eredményének lekérdezése (Result)

Működés

Használja a Result hívást a tranzakció eredményének lekérdezéséhez. A fizetés után rendszerünk visszairányítja a vásárlót az áruházba, úgy, hogy meghívja azt a ResponseUrl-t, amit az inicializáció (Init) során adott meg a kereskedő oldala. Miután rendszerünk meghívja a ResponseUrl-t, a kereskedő oldala elindíthatja a Result hívást.

Result hívás indításához szüksége lesz az adott tranzakció azonosítójára. Ezért a rendszerünkből érkező ResponseUrl hívás kiegészül a TransactionId GET paraméterrel, amely az adott tranzakció azonosítót biztosítja.

Fontos, hogy minden rendszerünkből érkező ResponseUrl hívás után indítson egy Result hívást, a vásárlói munkamenettől függetlenül. Ennek oka, hogy előfordulhat, hogy a ResponseUrl hívásra később, aszinkron módon, a háttérben kerül sor.

Rendszerünk aszinkron módon elindítja a NotificationUrl hívást, abban az esetben, ha beállt az adott tranzakció végstátusza. A NotificationUrl az inicializáció (Init) során kötelezően átadandó URL cím. Itt is fontos, hogy minden rendszerünkből érkező NotificationUrl hívás után indítson egy Result hívást.

Rendszerünk a Result hívás hatására értesül arról, hogy a kereskedő oldala megkapta a tranzakció eredményét. Ezért amennyiben a Result hívásra nem kerül sor, a tranzakció rendszerünkben a "megválaszolhatatlan" állapotot veszi fel.

Próbálja ki ezt a funkciót!

További részletekért a NotificationUrl használatáról látogassa meg a következő hivatkozást: URL Értesítés

A tranzakció állapotairól a rendszerünkben pedig a következő oldalon olvashat további információkat: Tranzakció Állapotok

Figyeljen arra, hogy Result kérést kizárólag ResponseUrl vagy NotificationUrl hívások hatására indítson. A kereskedő rendszeréből indokolatlanul, vagy ütemezett módon Result kérést indítani tilos!

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

API kérés paraméterek

A Result kérés egy (kötelező) paraméterrel rendelkezik

Mintakód

Tranzakció eredményének lekérése Result használatával

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

API válasz paraméterek

A Result kérés eredményét JSON formában válaszoljuk meg. A válasz a következő paramétereket tartalmazza:

Mintakód

A fenti Result kérésre adott válasz:

{
    "StoreName": "sdk_test",
    "ProviderName": "RawMBHSZEP",
    "TransactionId": "992c8e75435e6d4dfdf6415f0714cae8",
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": "Sikeres tranzakció",
    "Anum": "006761",
    "Amount": "100",
    "Currency": "HUF",
    "OrderId": "BF-TEST-ORDER",
    "UserId": "BF-TEST-USER",
    "Language": "HU",
    "ProviderTransactionId": "tr_tzftXkC-fcwaVPiAVVNgotmIhY_QXydL",
    "AutoCommit": "true",
    "CommitState": "APPROVED",
    "PaywallPaymentName": null,
    "PaywallRecurringPaymentEnabled": "false",
    "PaymentRegistrationType": "CIT",
    "SzepPocket": null,
    "ProviderResultCode": "000",
    "ProviderResultCode2": null,
    "PaymentLinkName": null,
    "Created": "2020-03-14 11:19:07",
    "ResponseId": "3202109280600047703"
}