Verifikáció részletes adatainak lekérdezése (Details)

Működés

Használja a Details hívást a tranzakció részletes adatainak lekérdezéséhez. Míg a Result hívásra adott válasz csupán a tranzakció alapadatait hordozza, a Details hívás további részletes információkat is tartalmaz az adott tranzakcióról (pl. szolgáltató specifikus adatokat).

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

A fizetési tranzakcióhoz kapcsolódó adatok közül a kommunikációs naplóbejegyzések (log) a fizetési tranzakció létrehozását követő 2 évig, míg minden egyéb adat a szolgáltatási szerződés megszűnéséig érhető el.

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

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

API kérés paraméterek

A Details kérés a következő paraméterekkel rendelkezik (a TransactionId átadása kötelező)

Paraméter	Típus	Érték	Leírás
TransactionId	string	32 karakter hosszú md5 hash	A tranzakció azonosítója a Nevogate rendszerében.
GetRelatedTransactions	boolean	true false (alapért.)	Olyan korábbi tranzakciók részletes adatainak lekérése, melyek OrderId paramétere megegyezik az aktuális tranzakció OrderId értékével.
GetInfoData	boolean	true false (alapért.)	Kérés a vásárlásra vonatkozó Info adatok visszaadására. (Init, InitRP vagy PaymentLinkCreate hívások során átadott vásárlási adatok esetén.)
GetPaymentAttributes	boolean	true false (alapért.)	A tranzakcióhoz tartozó fizetési mód adatok lekérése.

Mintakód

A tranzakció részletes adatainak lekérése Details használatával:

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

API válasz paraméterek

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

Paraméter	Típus	Érték	Leírás
CommonData	JSON object	egyedi értékek	A tranzakció alapadatai. (A Result hívás során is visszaadott adatok.)
ProviderSpecificData	JSON object	egyedi értékek	Szolgáltató specifikus kiegészítő adatok.
RelatedTransactions	JSON object	egyedi értékek	Olyan korábbi tranzakciók adatai melyek OrderId paramétere megegyezik az aktuális tranzakció OrderId értékével.
InfoData	JSON object	egyedi értékek	Az Info objektum adatai.
ResultCode	string	Az API kérés eredménye lehet: SUCCESSFUL Hiba esetén a következő eredménykódok jelölik a hiba okát: InactiveStore MissingParameter MissingRemoteAddress UnauthorizedAccess UnauthorizedRemoteAddress UnknownStore UnknownTransaction WrongApikey (Továbbá a szolgáltatókra vonatkozó specifikus eredménykódok is megjelenhetnek itt.)	Jelzi az API kérés eredményét: SUCCESSFUL: az API kérés sikeres.
ResultMessage	string	leírás	Az egyes ResultCode értékek szöveges magyarázata.
ProviderName	string	egyedi értékek	A tranzakcióhoz kiválasztott fizetési szolgáltató.
ResponseId	integer	egyedi értékek	A válaszüzenet egyedi azonosítója a Nevogate rendszerében.
PaymentAttributes	JSON object	egyedi értékek, amik a következők lehetnek: PaymentServiceProvider: barion cib global_payments kh mbh otp paypal paysafecard payu raiffeisen simplepay stripe teya unicredit viva_wallet worldline klarna quenta sepadirectdebit blik twisto paypo granit PaymentMethodLabels: bank_card wallet voucher_prepaid_giftcard szep_card ep_card bank_transfer rtp qr link nfc bnpl installment consumer_loan crypto qvik eam Wallet: google_pay apple_pay samsung_pay barion_pay paypal viva_wallet alipay wechat_pay mobile_pay link masterpass visa_checkout amex_checkout CardCompany: mastercard maestro visa american_express china_unionpay discover diners_club jcb other	A tranzakcióhoz tartozó fizetési adatok. Ezek a következőek: Fizetési mód, Fizetési típus, Tárca típus, Kártya típus

Mintakód

A fenti Details kérésre adott válasz (formázást követően):

{
    "CommonData":
    {
        "StoreName": "sdk_test",
        "ProviderName": "GP",
        "TransactionId": "a4d6f6f27f2116da21da62d705dbd7ef",
        "ResultCode": "SUCCESSFUL",
        "ResultMessage": "Sikeres tranzakció",
        "Anum": "006766",
        "Amount": "100",
        "Currency": "HUF",
        "OrderId": "TEST-ORDER-ID",
        "UserId": "TEST-USER-ID",
        "Language": "HU",
        "ProviderTransactionId": "tr_GVaydOjpVySGJycK15glvGgbLGxmCQyf",
        "AutoCommit": "false",
        "CommitState": "APPROVED",
        "Created": "2020-03-14 11:19:07",
        "ResponseId": "3202109280600047706"
    },
    "ProviderSpecificData":
    {
        ...
        "Amount": "100",
        "Currency": "HUF",
        "Language": "HU",
        "OrderId": "TEST-ORDER-ID",
        "UserId": "TEST-USER-ID",
        "ResponseUrl": "https://demo.nevogate.com/response.php",
        "NotificationUrl": null,
        "MaxNotificationSendAttempts": 0,
        "NotificationSendAttempts": 0,
        "NotificationSendSuccess": 0,
        "Extra": null,
        "AutoCommit" : "0",
        "CommitState": "1",
        "HasRefund": "0",
        "Created": "2017-11-17 13:12:36",
        "LastModified": "2017-11-17 13:14:07",
        "InvoiceDate": null,
        "GatewayPaymentPage": null,
        "ModuleName": null,
        "ModuleVersion": null,
        "StoreProviderId": "3103",
        "Error": null,
        "ResultMessage": null
    },
    "RelatedTransactions": null,
    "InfoData": null,
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "ProviderName": "GP",
    "ResponseId": "3202109280600047706",
    "PaymentAttributes": 
    {
        "PaymentServiceProvider": "global_payments",
        "PaymentMethodLabels": [
            "bank_card"
        ],
        "Wallet": null,
        "CardCompany": null
    }
}