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


---

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