> For the complete documentation index, see [llms.txt](https://docs.nevogate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nevogate.com/ismetlodo-fizetes-recurring-payment/regisztralt-fizetoeszkoez-kezelese/fizetoeszkoz-regisztracio-adatainak-lekerdezese-tranzakcio-azonositoval.md).

# 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

{% hint style="warning" %}
Az érvénytelenített fizetőeszköz-regisztrációk és a lejárt fizetőeszközök adatait nem adjuk vissza.
{% endhint %}

[<mark style="color:blue;background-color:blue;">**Próbálja ki ezt a funkciót!**</mark>](https://demo.nevogate.com/views/?action=getPaymentRegistration)

### **Az API kérés paraméterei**

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

<table><thead><tr><th>Művelet</th><th width="141">HTTP kérés</th><th>Adatok</th></tr></thead><tbody><tr><td><code>GetPaymentRegistration</code></td><td><code>POST</code></td><td>method=<code>GetPaymentRegistration</code><br><br>json={JSON encode-olt paraméterek}</td></tr></tbody></table>

#### Paraméterek

| Paraméter       | Típus                              | Érték    | Leírás                                              |
| --------------- | ---------------------------------- | -------- | --------------------------------------------------- |
| `TransactionId` | <p>string<br><br>(32 karakter)</p> | 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:

```php
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:

<table><thead><tr><th width="227">Paraméter</th><th width="129">Típus</th><th width="196">Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><a href="#a-data-parameter-elemei"><code>Data</code></a></td><td>JSON object</td><td>egyedi értékek</td><td>A tranzakcióhoz tartozó regisztrált fizetőeszköz adatait tartalmazó objektum.</td></tr><tr><td><code>ResultCode</code></td><td>string</td><td><p>Sikeres lekérdezés:</p><ul><li>SUCCESSFUL</li></ul><p>Sikertelen lekérdezés esetén:</p><ul><li>InactiveStore</li><li>MissingParameter</li><li>MissingRemoteAddress</li><li>UnauthorizedAccess</li><li>UnauthorizedRemoteAddress</li><li>UnknownReferenceTransaction</li><li>UnknownStore</li><li>UnknownTransaction</li><li>WrongApikey</li><li>WrongParameter</li></ul></td><td><p>Jelzi a lekérdezés eredményét.</p><p>Sikertelen lekérdezés esetén a paraméter értéke jelzi a hiba okát.</p></td></tr><tr><td><code>ResultMessage</code></td><td>string</td><td>leírás</td><td>Az egyes <code>ResultCode</code> értékek szöveges magyarázata.</td></tr><tr><td><code>ResponseId</code></td><td>Integer</td><td>egyedi értékek</td><td>A válaszüzenet egyedi azonosítója a <em>Nevogate</em> rendszerében.</td></tr></tbody></table>

#### 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`           | <p>A regisztrált fizetőeszköz típusa:</p><ul><li><code>BankCard</code></li><li><code>Wallet</code></li><li><code>AccountNumber</code></li><li><code>SzepCard</code></li></ul> |
| `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:

```php
{
  "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"
}
```