> 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/egyszeri-fizetesek-one-time-payment/atutalas/tranzakcio-ervenytelenitese-cancel.md).

# Tranzakció érvénytelenítése (Cancel)

### Működés

Használja a `Cancel` hívást a tranzakció érvénytelenítéséhez. Tranzakció érvénytelenítésére mindaddig lehetőség van, amíg a tranzakció `PENDING`, vagy `OPEN` státuszban van. A sikeres érvénytelenítés hatására a tranzakció `CANCELED` státuszba kerül, így innentől már sikeres tranzakció létrehozása nem lehetséges.

{% hint style="info" %}
Az érvénytelenítés művelet jelenleg a következő fizetési szolgáltatók esetén érhető el:

* *Gránit FairPay*
* *Raiffeisen Pay*
* *SimplePay*
  {% endhint %}

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

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

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="117">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>TransactionId</code></td><td>string</td><td>32 karakter hosszú md5 hash</td><td>A tranzakció azonosítója a <em>Nevogate</em> rendszerében.</td></tr></tbody></table>

#### **Mintakód**

A tranzakció érvénytelenítése `Cancel` 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 'Cancel | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Cancel' \
  --data 'json=
    {
        "TransactionId":"b8156ec464a00c34b947a1aac4891e0d"
    }'
```

{% endcode %}

### **API válasz paraméterek**

A `Cancel` kérés 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="249">Paraméter</th><th width="133">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>TransactionId</code></td><td>string</td><td>32 karakter hosszú md5 hash</td><td>A tranzakció azonosítója a <em>Nevogate</em> rendszerében.</td></tr><tr><td><code>ResultCode</code></td><td>string</td><td><p>Az API kérés eredménye lehet:</p><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>UnknownStore</li><li>UnknownTransaction</li><li>WrongApikey</li><li>WrongTransactionStatus</li></ul><p>(Továbbá a szolgáltatókra vonatkozó specifikus eredménykódok is megjelenhetnek itt.)</p></td><td><p>Jelzi az API kérés eredményét:</p><ul><li>SUCCESSFUL: az API kérés sikeres.</li></ul></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 fenti `Cancel` kérésre adott válasz:

{% code overflow="wrap" %}

```php
{
    "TransactionId": "b8156ec464a00c34b947a1aac4891e0d",
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "ResponseId": "3382412101354326635"
}
```

{% endcode %}