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

### Működés

Használja az `CancelAllPaymentRegistrations` funkciót egy vásárló összes fizetőeszköz-regisztrációjának érvénytelenítéséhez egy adott fizetési szolgáltatónál. Az API hívásban adja át a bolt és a fizetési szolgáltató nevét, illetve a vásárló egyedi azonosítóját. A kérésre adott válasz (`ResultData`) tartalmazza a sikeresen és sikertelenül érvénytelenített fizetőeszköz-regisztrációkhoz tartozó referencia tranzakciókat.\
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=cancelAllPaymentRegistrations)

### **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="128">HTTP kérés</th><th>Adatok</th></tr></thead><tbody><tr><td><code>CancelAllPaymentRegistrations</code></td><td><code>POST</code></td><td>method=<code>CancelAllPaymentRegistrations</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="98">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>StoreName</code></td><td>string</td><td>A <em>Nevogate</em> szerződésben kerül meghatározásra.</td><td>Rendszerünkben tárolt egyedi bolt azonosító.</td></tr><tr><td><code>ProviderName</code></td><td>string</td><td><ul><li>GP (<em>Global Payments</em>)</li></ul></td><td>A tranzakcióhoz tartozó fizetési szolgáltató.</td></tr><tr><td><code>UserId</code></td><td>string</td><td>szabadon választott<br><br>(kivéve e-mail címek és személyes adatok)</td><td>A fizetőeszköz-regisztrációhoz használt vásárló-azonosító a kereskedő áruházában.</td></tr></tbody></table>

#### **Mintakód**

Az összes fizetőeszköz regisztrációjának érvénytelenítése `CancelAllPaymentRegistrations` 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 'CancelAllPaymentRegistrations | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=CancelAllPaymentRegistrations' \
  --data 'json=
    {
        "StoreName":"sdk_test",
        "ProviderName":"GP",
        "UserId":"TEST-USER-ID-REG-DEL"
    }'
```

{% endcode %}

### API válasz paraméterek

A `CancelAllPaymentRegistrations` 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="248">Paraméter</th><th width="128">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><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>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>UnknownProvider</li><li>UnknownStore</li><li>WrongApikey</li></ul><p>Illetve további szolgáltató specifikus eredménykódok.</p></td><td>SUCCESSFUL: az API kérés sikeres.</td></tr><tr><td><a href="#a-resultdata-parameter-elemei"><code>ResultData</code></a></td><td>JSON object</td><td>egyedi értékek</td><td>Tartalmazza a sikeresen és sikertelenül érvénytelenített regisztrációkhoz tartozó referencia tranzakciókat.</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>

#### A ResultData paraméter elemei

<table data-full-width="true"><thead><tr><th width="248">Paraméter</th><th width="132">Típus</th><th>É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ítésre kerülő fizetőeszköz-regisztrációhoz tartozó referencia tranzakció azonosító (a <em>Nevogate</em> rendszerében).</td></tr><tr><td><code>Message</code></td><td>string</td><td><ul><li>SUCCESSFUL</li><li>Egyéb szöveges hibaüzenet</li></ul></td><td>Az adott fizetőeszköz-regisztráció érvénytelenítésének eredményét írja le.</td></tr></tbody></table>

#### Mintakód

Az összes fizetőeszköz-regisztráció sikeres érvénytelenítésére adott válasz:

{% code overflow="wrap" %}

```php
{
    "ResultCode":"SUCCESSFUL",
    "ResultData":
    [
        {
            "TransactionId":"35583f7e0dd52499c16835acdbff6bd4",
            "Message":"SUCCESSFUL"
        },
        {
            "TransactionId":"8e0c1de0aa4468d94223e368ed704c98",
            "Message":"SUCCESSFUL"
        }
    ],
    "ResultMessage":null,
    "ResponseId": "3202109280600047722"
}
```

{% endcode %}