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


---

# 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-ervenytelenitese.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.
