# 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 %}


---

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