> 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-ervenytelenitese.md).

# Fizetési hivatkozás érvénytelenítése

### Működés

Használja a `PaymentLinkCancel` funkciót egy fizetési hivatkozás érvénytelenítéséhez. Felhívjuk figyelmét, hogy kizárólag olyan fizetési hivatkozás érvényteleníthető, amelyhez még nem tartozik sikeres tranzakció és a link még érvényes, tehát nem járt le és nem lett érvénytelenítve.

{% hint style="info" %}
Egy sikeresen érvénytelenített fizetési hivatkozás nem élesíthető újra, ezért érvénytelenítés után a fizetési hivatkozással később sem hajthatók végre újabb tranzakciók. Egy érvénytelenített fizetési hivatkozással megegyező fizetéshez újabb hivatkozás létrehozása szükséges.
{% endhint %}

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

### 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>PaymentLinkCancel</code></td><td><code>POST</code></td><td>method=<code>PaymentLinkCancel</code><br><br>json={JSON encode-olt paraméterek}</td></tr></tbody></table>

**Kötelező paraméterek**

<table data-full-width="true"><thead><tr><th>Paraméter</th><th>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ék</td><td>A fizetési hivatkozás egyedi azonosítója a <em>Nevogate</em> rendszerében.</td></tr></tbody></table>

#### **Mintakód**

Fizetési hivatkozás érvénytelenítése `PaymentLinkCancel` 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 'PaymentLinkCancel | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=PaymentLinkCancel' \
  --data 'json=
    {
        "PaymentLinkName":"pl_d6b8323abb1c839a8cd6434c67bbbbef"
    }'
```

{% endcode %}

### API válasz paraméterek

A `PaymentLinkCancel` 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="250">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><tr><td><code>Status</code></td><td>string</td><td><ul><li>PENDING</li><li>SUCCESSFUL</li><li>ERROR</li><li>CANCELED</li><li>TIMEOUT</li></ul></td><td>A fizetési hivatkozás státusza.</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 hívá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 `PaymentLinkCancel` kérésre adott válasz:

{% code overflow="wrap" %}

```php
{
    "PaymentLinkName":"pl_d6b8323abb1c839a8cd6434c67bbbbef",
    "Status":"CANCELED",
    "ResultCode":"SUCCESSFUL",
    "ResultMessage":"Fizetési link érvénytelenítése sikeres",
    "ResponseId": "3202109280600047728"
}
```

{% endcode %}