# 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ó](https://docs.nevogate.com/fizetoeszkoz-verifikacio/altalanos-ismerteto) illetve [Referencia tranzakció](https://docs.nevogate.com/fizetoeszkoz-verifikacio/altalanos-ismerteto)

{% 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)](https://docs.nevogate.com/egykattintasos-fizetes-one-click-payment/altalanos-cit-ismerteto)
* [Ismétlődő MIT fizetés (Recurring payment)](https://docs.nevogate.com/ismetlodo-fizetes-recurring-payment/altalanos-mit-ismerteto)

\
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](https://docs.nevogate.com/egyszeri-fizetesek-one-time-payment/bankkartya-es-mobiltarca/azonnali-terheles/tranzakcio-oesszegenek-visszateritese-refund)
{% 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="../segedlet/eros-uegyfel-hitelesites-psd2-sca">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 %}