# 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"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nevogate.com/egykattintasos-fizetes-one-click-payment/regisztralt-fizetoeszkoez-kezelese/fizetoeszkoz-regisztracio-adatainak-lekerdezese-tranzakcio-azonositoval.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.