> 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/ismetlodo-fizetes-recurring-payment/regisztralt-fizetoeszkoez-kezelese/fizetoeszkoez-regisztracio-ervenytelenitese.md).

# Fizetőeszköz-regisztráció érvénytelenítése

### Működés

Használja a `CancelPaymentRegistration` funkciót egy fizetőeszköz regisztrációjának érvénytelenítéséhez. Az API hívásban adja át az érvényteleníteni kívánt regisztrációhoz tartozó referencia tranzakció azonosítót.\
Egy érvénytelenített regisztrációjú fizetőeszközzel nem lehet további rákövetkező fizetéseket (CIT, MIT), illetve kifizetést (PayOut) indítani, ehhez az adott fizetőeszköz ismételt regisztrációja szükséges.

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

### **Az API kérés paraméterei**

#### **Az API kérés általános információi**

<table data-full-width="true"><thead><tr><th>Művelet</th><th width="132">HTTP kérés</th><th>Adatok</th></tr></thead><tbody><tr><td><code>CancelPaymentRegistration</code></td><td><code>POST</code></td><td>method=<code>CancelPaymentRegistration</code><br><br>json={JSON encode-olt paraméterek}</td></tr></tbody></table>

#### Paraméterek

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="137">Típus</th><th width="117">Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>TransactionId</code></td><td>string<br><br>(32 karakter)</td><td>md5 hash</td><td>Az érvényteleníteni kívánt regisztrációhoz tartozó referencia tranzakció azonosító (a <em>Nevogate</em> rendszerében).</td></tr></tbody></table>

#### **Mintakód**

Fizetőeszköz regisztrációjának érvénytelenítése `CancelPaymentRegistration` 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 'CancelPaymentRegistration | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=CancelPaymentRegistration' \
  --data 'json=
    {
        "TransactionId":"5a1871e916037166868bf6c303cb7f64"
    }'
```

{% endcode %}

### API válasz paraméterek

A `CancelPaymentRegistration` 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="247">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><p>string</p><p>(32 karakter)</p></td><td>md5 hash</td><td>Az érvényteleníteni kívánt regisztrációhoz tartozó referencia tranzakció azonosító (a <em>Nevogate</em> rendszerében).</td></tr><tr><td><code>ResultCode</code></td><td>string</td><td><p>Sikeres érvénytelenítés:</p><ul><li>SUCCESSFUL</li></ul><p>Sikertelen érvénytelenítés esetén:</p><ul><li>InactiveStore</li><li>InactiveProvider</li><li>MissingParameter</li><li>MissingRemoteAddress</li><li>UnauthorizedAccess</li><li>UnauthorizedRemoteAddress</li><li>UnknownStore</li><li>UnknownTransaction</li><li>WrongApikey</li></ul><p>Illetve további szolgáltató specifikus eredménykódok.</p></td><td><p>Jelzi a regisztráció érvénytelenítés eredményét.</p><p>Sikertelen érvénytelenítés esetén a paraméter értéke jelzi a hiba okát.</p></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 fizetőeszköz-regisztráció sikeres érvénytelenítésére adott válasz:

{% code overflow="wrap" %}

```php
{
    "TransactionId":"5a1871e916037166868bf6c303cb7f64",
    "ResultCode":"SUCCESSFUL",
    "ResultMessage":null,
    "ResponseId": "3202109280600047721"
}
```

{% endcode %}