> 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/kiegeszito-szolgaltatasok/fizetesi-hivatkozas-paylink/fizetesi-hivatkozas-reszletes-adatainak-lekerdezese.md).

# Fizetési hivatkozás részletes adatainak lekérdezése

### Működés

Használja a `PaymentLinkDetails` funkciót egy fizetési hivatkozás adatainak lekérdezéséhez. A lekérdezett válasz tartalmazza az adott fizetési hivatkozás és a hivatkozáshoz tartozó tranzakció adatait is.

{% hint style="info" %}
Egy adott fizetési hivatkozáshoz több tranzakció is tartozhat, a tranzakciók közül viszont csak egy lehet sikeres.
{% endhint %}

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

### API kérés paraméterek

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

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

{% hint style="info" %}
Az API kérésekhez kapcsolódó paramétereket két táblázatba soroljuk fel a könnyebb átláthatóság kedvéért. Természetesen az egyes paraméterek megjelenhetnek ugyanabban az API kérésben.
{% endhint %}

Az API paraméterek felosztása a következő:

* kötelező paraméterek
* opcionális paraméterek

#### **Kötelező paraméterek**

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="132">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>PaymentLinkName</code></td><td><p>string<br></p><p>(35 karakter)</p></td><td>egyedi értékek</td><td>A fizetési hivatkozás egyedi azonosítója a <em>Nevogate</em> rendszerében.</td></tr></tbody></table>

#### Opcionális paraméterek

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="129">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>GetInfoData</code></td><td>boolean</td><td><ul><li>false</li><li>true</li></ul></td><td>Jelzi, hogy a <code>PaymentLinkDetails</code> hívás során, az adott vásárlásra vonatkozó Info adatok is visszaadásra kerüljenek vagy nem.</td></tr></tbody></table>

#### **Mintakód**

Fizetési hivatkozás adatainak lekérdezése `PaymentLinkDetails` kérés használatával:

{% code overflow="wrap" %}

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

{% endcode %}

### API válasz paraméterek

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

<table data-full-width="true"><thead><tr><th width="251">Paraméter</th><th width="128">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>CommonData</code></td><td>JSON object</td><td>egyedi értékek</td><td>Az objektum tartalmazza a fizetési hivatkozás alap adatait (melyeket a <code>PaymentLinkCreate</code> hívásra adott válasz is tartalmaz).</td></tr><tr><td><code>RelatedTransactions</code></td><td>JSON object</td><td>egyedi értékek</td><td>Az objektum tartalmazza az adott fizetési hivatkozáshoz tartozó további tranzakciókat.</td></tr><tr><td><code>InfoData</code></td><td>JSON object</td><td>egyedi értékek</td><td>Az objektum tartalmazza a fizetési hivatkozás létrehozása során megadott <code>Info</code> adatokat.</td></tr><tr><td><code>ResultCode</code></td><td>string</td><td><ul><li>SUCCESSFUL</li></ul><p>Hiba esetén a következő eredménykódok jelölik a hiba okát:</p><ul><li>InactiveStore</li><li>MissingParameter</li><li>MissingRemoteAddress</li><li>UnauthorizedAccess</li><li>UnauthorizedRemoteAddress</li><li>UknownPaymentLink</li><li>UnknownStore</li><li>WrongApikey</li></ul></td><td>Jelzi a lekérdezés eredményét.</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>

#### **Mintakód**

A `PaymentLinkDetails` kérésre adott válasz formázás után:

{% code overflow="wrap" %}

```php
{
    "CommonData":
    {
        "PaymentLinkUrl":"https://system-test.paymentgateway.hu/PaymentLink/pl_d6b8323abb1c839a8cd6434c67bbbbef",
        "PaymentLinkQR":"https://system-test.paymentgateway.hu/PaymentQR/pl_d6b8323abb1c839a8cd6434c67bbbbef.png",
        "ResultCode":"SUCCESSFUL",
        "ResultMessage":null,
        "PaymentLinkName":"pl_d6b8323abb1c839a8cd6434c67bbbbef",
        "ProviderName":"Borgun2",
        "Amount":"100",
        "Currency":"HUF",
        "Language":"HU",
        "OrderId":"TEST-ORDER-ID",
        "UserId":"TEST-USER-ID",
        "AutoCommit":"1",
        "ExpirationTime":null,
        "NotificationUrl":null,
        "NotificationEmail":"paymentlink@notification.email",
        "EmailNotificationOnlySuccess":"0",
        "EmailNotificationTime":null,
        "Extra":null,
        "Status":"PENDING",
        "Created":"2017-11-20 14:43:31",
        "LastModified":"2017-11-20 14:43:31",
        "ResponseId": "3202109280600047727"
    },
    "RelatedTransactions": [],
    "InfoData": null,
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "ResponseId": "3202109280600047727"
}
```

{% endcode %}