Fizetőeszköz-regisztráció adatainak lekérdezése tranzakció azonosítóval

Működés

Használja a GetPaymentRegistration funkciót egy adott tranzakcióhoz tartozó regisztrált fizeetőeszköz adatainak lekérdezésére. Sikeres válasz esetén az alábbi adatokat tartalmazza:

• a fizetőeszköz-regisztráció típusa

• a vásárláshoz tartozó regisztrált fizetőeszköz adatai

• a fizetőeszköz-regisztráció során létrejött referencia tranzakció adatai

Az érvénytelenített fizetőeszköz-regisztrációk és a lejárt fizetőeszközök adatait nem adjuk vissza.

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

Az API kérés paraméterei

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

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

Paraméterek

Paraméter	Típus	Érték	Leírás
TransactionId	string (32 karakter)	md5 hash	A tranzakció azonosító (a Nevogate rendszerében).

Mintakód

Adott vásárlóhoz tartozó regisztrált fizetőeszköz adatainak lekérdezése GetPaymentRegistration kérés használatával:

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

API válasz paraméterek

A GetPaymentRegistration 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
Data	JSON object	egyedi értékek	A tranzakcióhoz tartozó regisztrált fizetőeszköz adatait tartalmazó objektum.
ResultCode	string	Sikeres lekérdezés: SUCCESSFUL Sikertelen lekérdezés esetén: InactiveStore MissingParameter MissingRemoteAddress UnauthorizedAccess UnauthorizedRemoteAddress UnknownReferenceTransaction UnknownStore UnknownTransaction WrongApikey WrongParameter	Jelzi a lekérdezés eredményét. Sikertelen lekérdezés esetén a paraméter értéke jelzi a hiba okát.
ResultMessage	string	leírás	Az egyes ResultCode értékek szöveges magyarázata.
ResponseId	Integer	egyedi értékek	A válaszüzenet egyedi azonosítója a Nevogate rendszerében.

A Data paraméter elemei

Az alábbi adatok a Data nevű paraméterben, fizetőeszköz-regisztráció típusonként bontva kerülnek átadásra:

Paraméter	Leírás
ReferenceTransactionId	A fizetőeszköz-regisztrációhoz kapcsolódó tranzakció azonosítója a Nevogate rendszerében.
AutoCommit	A referencia tranzakció végrehajtási módja, mely jelenthet azonnali terhelést vagy az összeg előzetes befoglalását.
Currency	A referencia tranzakció devizaneme.
PaymentDevice	A regisztrált fizetőeszköz típusa: BankCard Wallet AccountNumber SzepCard
PaymentDeviceBrand	A regisztrált fizetőeszköz márkája.
PaymentDeviceNumber	A regisztrált fizetőeszköz azonosító száma, pl. a bankkártya utolsó 4 számjegye, számlaszám, stb.
PaymentDeviceExpiration	A regisztrált fizetőeszköz lejárati ideje.
RegistrationExpiration	A fizetőeszköz-regisztráció érvényességének vége.
RecurringFrequency	A rákövetkező fizetések gyakorisága.
FixAmount	Jelzi, hogy a rákövetkező fizetések megegyeznek vagy nem egyeznek meg a referencia tranzakció összegével.
Created	A referencia tranzakció létrehozásának időpontja.

Mintakód

A sikeres fizetőeszköz-regisztráció lekérdezésre adott válasz:

{
  "Data": {
    "CIT": [
      {
        "ReferenceTransactionId": "42a8b536eb3acd9f780d5a96de1b022b",
        "AutoCommit": 0,
        "Currency": "HUF",
        "PaymentDevice": "BankCard",
        "PaymentDeviceBrand": "Visa",
        "PaymentDeviceNumber": "5559",
        "PaymentDeviceExpiration": "2022-02-28",
        "RegistrationExpiration": null,
        "RecurringFrequency": 0,
        "FixAmount": null,
        "Created": "2021-05-27 11:34:03"
      }
    ]
  },
  "ResultCode": "SUCCESSFUL",
  "ResultMessage": null
  "ResponseId": "3202109280600047720"
}