# Kifizetés (PayOut)

A *PayOut* segítségével a kereskedő kifizetést tud kezdeményezni a vásárló bankkártyájára (ellenirányú tranzakció). A kifizetés feltétele a kedvezményezett bankkártya előzetes regisztrációja vagy verifikációja. A regisztráció (vagy verifikáció) során létrejön a referencia tranzakció, mely segítségével rendszerünkben beazonosíthatóvá válik a kedvezményezett bankkártya.

További részletekért látogassa meg a következő oldalakat:

[Fizetőeszköz-regisztráció](/fizetoeszkoz-verifikacio/altalanos-ismerteto.md) illetve [Referencia tranzakció](/fizetoeszkoz-verifikacio/altalanos-ismerteto.md)

{% hint style="info" %}
A regisztrált (verifikált) bankkártya segítségével nem csak kifizetés, de CIT és MIT típusú fizetési tranzakció is létrehozható.

További részletekért látogassa meg a következő oldalakat:

* [Egykattintásos CIT fizetés (One-click payment)](/egykattintasos-fizetes-one-click-payment/altalanos-cit-ismerteto.md)
* [Ismétlődő MIT fizetés (Recurring payment)](/ismetlodo-fizetes-recurring-payment/altalanos-mit-ismerteto.md)

\
Korábban regisztrált bankkártya esetén a kifizetéshez szükséges referencia tranzakció már rendelkezésre áll rendszerünkben a kifizetés végrehajtásához.

\
A *PayOut* működése nagyban hasonlít a tranzakciók összegének visszatérítéséhez, amiről a következő oldalon olvashat:

[Tranzakció összegének visszatérítése](/egyszeri-fizetesek-one-time-payment/bankkartya-es-mobiltarca/azonnali-terheles/tranzakcio-oesszegenek-visszateritese-refund.md)
{% endhint %}

### Egyedi jellemzők

A *PayOut* használata előtt vegye figyelembe a szolgáltatás egyedi jellemzőit:

* egy referencia tranzakció tetszőleges számú kifizetésre használható fel
* a kifizetés összege tetszőleges (meghaladhatja a referencia tranzakció összegét is)
* a kifizetés használata nem időkorlátos, a kereskedő bármikor indíthat ellenirányú tranzakciót
* a sikeres kifizetés átfutási ideje maximum 30 perc (az összeg jellemzően 1-2 percen belül megjelenik a kedvezményezett számláján)
* a kifizetés menete különböző kártyatípusoknál a következő:
  * bankkártya (debit) esetén a kifizetés összege a kártyához tartozó folyószámlán kerül jóváírásra
  * hitelkártya (credit) esetén a kifizetés összege a kártyához tartozó hitelkeret-tartozás összegét csökkenti

{% hint style="info" %}
*PayOut* használatát jelenleg csak a *Global Payments* fizetési szolgáltató támogatja.
{% endhint %}

### Működés

Használja a `Payout` műveletet kifizetés (*ellenirányú tranzakció*) létrehozásához a *PayOut* segítségével.

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

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

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

<table data-full-width="true"><thead><tr><th width="223">Művelet</th><th>HTTP kérés</th><th>Adatok</th></tr></thead><tbody><tr><td><code>Payout</code></td><td><code>POST</code></td><td>method=<code>Payout</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 width="140">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>PayoutType</code></td><td>string</td><td><ul><li>B2P</li><li>WIN</li></ul></td><td><p>Jelzi a kifizetés jogi típusát (a típusok technikailag azonosak).<br><br>(Kizárólag a fizetési szolgáltatóval kötött szerződésben meghatározott típus használható kifizetésre.)<br><br>Jellemzők:</p><ul><li>B2P: általános kifizetés (pl. visszatérítés, kártérítés, stb.)</li><li>WIN: nyeremény kifizetés szerencsejáték esetén<br></li></ul></td></tr><tr><td><code>ReferenceTransactionId</code></td><td>string</td><td>egyedi értékek</td><td>A fizetőeszköz regisztrációhoz kapcsolódó tranzakció azonosítója a <em>Nevogate</em> rendszerében.</td></tr><tr><td><code>Amount</code></td><td>number</td><td>szabadon választható</td><td>A kifizetés összege.<br><br>(Magyar forint (HUF) esetén értéke egész szám.)</td></tr><tr><td><code>Info</code></td><td>string</td><td>egyedi értékek</td><td>A vásárlás és a vásárló adatai az erős ügyfél-hitelesítéshez (<a href="/pages/w2bB87azm3s2wK3Gnlgp">PSD2/SCA</a>).<br><br>Az SCA "Általános vásárlói adatok" kötelező paramétereinek megadása kötelező.</td></tr></tbody></table>

#### **Opcionális paraméterek**

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="141">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>OrderId</code></td><td>string<br><br>(255 karakter)</td><td>szabadon választható, egyedi érték</td><td><p>A megrendelés azonosítója a kereskedő áruházában.</p><p>(Lehetővé teszi a tranzakció visszakeresését, használata erősen javasolt.)</p></td></tr><tr><td><code>AdditionalMessage</code></td><td>string<br><br>(65 karakter)</td><td>egyedi értékek</td><td>A kifizetéshez megadható egyedi üzenet (a közlemény mezőben jelenik meg a kedvezményezettnél).</td></tr><tr><td><code>ModuleName</code></td><td>string<br><br>(32 karakter)</td><td>egyedi értékek</td><td>A kereskedő oldalán használt szervízcsomag, programnyelv, keretrendszer, modul, stb. megnevezése.</td></tr><tr><td><code>ModuleVersion</code></td><td>string<br><br>(8 karakter)</td><td>verziószám</td><td>A kereskedő oldalán használt szervízcsomag, programnyelv, keretrendszer, modul, stb. verziószáma.</td></tr></tbody></table>

#### **Mintakód**

Kifizetés (ellenirányú tranzakció) indítása `Payout` 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 'Payout | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Payout' \
  --data 'json=
    {
        "PayoutType":"B2P",
        "ReferenceTransactionId":"dced1a3238b58787843c82123086f614",
        "Amount":200,
        "OrderId":"TEST-ORDER-ID-PAYOUT",
        "AdditionalMessage":"TEST-PAYOUT-MESSAGE",
        "Info":"eyJDdXN0b21lciI6eyJHZW5lcmFsIjp7IkZpcnN0TmFtZSI6IkpvaG4iLCJMYXN0TmFtZSI6IkRvZSIsIkVtYWlsIjoidGVzdEB0ZXN0bWFpbC5jb20ifX19"
    }'
```

{% endcode %}

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

Az `Payout` 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="269">Paraméter</th><th width="122">Típus</th><th width="297">Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>ResultCode</code></td><td>string</td><td><p>Az összeg kifizetésének elindítása sikeresen megtörtént:</p><ul><li>SUCCESSFUL</li></ul><p><br>Az összeg kifizetésének elindítása sikertelen volt:</p><ul><li>ERROR</li><li>FunctionNotImplemented</li><li>InactiveStore</li><li>InactiveProvider</li><li>MissingParameter</li><li>MissingRemoteAddress</li><li>UnauthorizedAccess</li><li>UnauthorizedRemoteAddress</li><li>UnknownReferenceTransaction</li><li>UnknownStore</li><li>WrongApikey</li><li>WrongParameter</li></ul><p>(Továbbá a szolgáltatókra vonatkozó specifikus eredménykódok is megjelenhetnek itt.)</p></td><td><p>Jelzi a kifizetés elindításának eredményét.</p><p>Sikertelen kifizeté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>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</li></ul></td><td>A tranzakcióhoz kiválasztott fizetési szolgáltató.<br><br>(Ezt a funkciót jelenleg csak a <em>Global Payments</em> támogatja.)</td></tr><tr><td><code>PayoutType</code></td><td>string</td><td><ul><li>B2P</li><li>WIN</li></ul></td><td>Jelzi a kifizetés jogi típusát.</td></tr><tr><td><code>PayoutId</code></td><td>string</td><td>egyedi értékek</td><td>A kifizetés azonosítója a <em>Nevogate</em> rendszerében.</td></tr><tr><td><code>OrderId</code></td><td>string</td><td>szabadon választható, egyedi érték</td><td><p>A megrendelés azonosítója a kereskedő áruházában.<br></p><p>(Lehetővé teszi a tranzakció visszakeresését.)</p></td></tr><tr><td><code>UserId</code></td><td>string</td><td>szabadon választható<br><br>(kivéve e-mail címek)</td><td><p>A vásárló azonosítója a kereskedő áruházában.<br></p><p>(Lehetővé teszi a tranzakció visszakeresését.)</p></td></tr><tr><td><code>AdditionalMessage</code></td><td>string</td><td>egyedi értékek</td><td>A kifizetéshez megadott egyedi üzenet (a közlemény mezőben jelenik meg a kedvezményezettnél).</td></tr><tr><td><code>Amount</code></td><td>number</td><td>egyedi értékek</td><td>Kifizetésre kerülő összeg.</td></tr><tr><td><code>AuthCode</code></td><td>string</td><td>egyedi értékek</td><td>A kifizetés engedélyszáma, amely a fizetési szolgáltató rendszerében jön létre.</td></tr><tr><td><code>Currency</code></td><td>string<br><br>(3 karakter)</td><td><ul><li>HUF (alapért.)</li><li>EUR</li><li>USD</li><li>...</li></ul></td><td><p>A fizetés devizaneme.<br></p><p>(Értékei fizetési szolgáltatónként és szerződésenként eltérőek lehetnek.)</p></td></tr><tr><td><code>Created</code></td><td>string</td><td>dátum</td><td>A kifizetés létrehozásának időpontja.</td></tr><tr><td><code>ReferenceTransactionId</code></td><td>string</td><td>egyedi értékek</td><td>A fizetőeszköz regisztrációhoz kapcsolódó tranzakció azonosítója a <em>Nevogate</em> rendszerében.</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 `Payout` kérésre adott válasz:

{% code overflow="wrap" %}

```php
{
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "StoreName": "sdk_test",
    "ProviderName": "GP",
    "PayoutType": "B2P",
    "PayoutId": "po_ab70474b13a6e96bc42840cfd6d4ae91",
    "OrderId": "TEST-ORDER-ID-PAYOUT",
    "UserId": "TEST-USER-ID",
    "AdditionalMessage": "TEST-PAYOUT-MESSAGE",
    "Amount": 200,
    "Currency": "HUF",
    "AuthCode": "G913DO",
    "Created": "2021-07-19 11:23:01",
    "ReferenceTransactionId": "dced1a3238b58787843c82123086f614",
    "ResponseId": "3202109280600047724"
}
```

{% 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/kifizetes-payout.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.