> 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/egyszeri-fizetesek-one-time-payment/szep-kartya/tranzakcio-inicializalasa-init/k-and-h-specifikus-parameterek.md).

# K\&H specifikus paraméterek

A *K\&H SZÉP Kártyás* fizetésnél az alszámla (*zseb*) adatai az `Extra` paraméterben kerülnek átadásra a `KhbCardPocketId` változó segítségével, vagy a `SzepPocket` változón keresztül.

{% hint style="info" %}
Az API kérésekhez kapcsolódó paramétereket két táblázatba soroljuk fel a könnyebb átláthatóság kedvéért. Természetesen az egyes paraméterek megjelenhetnek ugyanabban az API kérésben.

Az API paraméterek felosztása a következő:

* kötelező paraméterek
  * `Extra` paraméterek
* opcionális paraméterek
  {% endhint %}

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

#### Kötelező paraméterek

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="144">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>KHBSZEP</li><li>RawKHBSZEP</li></ul></td><td>A tranzakcióhoz kiválasztott fizetési szolgáltató.</td></tr><tr><td><code>ResponseUrl</code></td><td>string<br><br>(255 karakter)</td><td>szabadon választható</td><td>Visszatérési URL: tranzakciót követően, rendszerünk erre a címre irányítja vissza a vásárlót.</td></tr><tr><td><code>NotificationUrl</code></td><td>string<br><br>(255 karakter)</td><td>szabadon választható</td><td>Rendszerünk ezen a címen értesíti a kereskedőt a tranzakció státuszának változásáról (<a href="/pages/zTAyqMVjv8jpa0c4nMWG">URL értesítés</a>).</td></tr><tr><td><code>Amount</code></td><td>number</td><td><p>szabadon választható</p><p>(egész szám)</p></td><td>Bruttó végösszeg amit a vásárló kifizet.</td></tr><tr><td><code>Extra</code> *</td><td>string</td><td><p><code>KhbCardPocketId</code> változó</p><p>(ezt a változót az <a href="/pages/XaOHnljbNm5MGxPqLjdh">extra paraméterek értékeire vonatkozó szabályok</a> alapján kell létrehozni)</p></td><td><p>A fizetéshez használt alszámla (<em>zseb</em>) átadásának módja.<br><br>Részletekért látogassa meg a következő oldalt: <a href="/pages/WZPexCnBVK1qi3WzzdhF">K&#x26;H Extra paraméterek</a>)<br><br>* A <code>KhbCardPocketId</code> paramétert csak KHBSZEP <code>ProviderName</code> érték használata esetén kell átadni.</p><p>RawKHBSZEP <code>ProviderName</code> használata esetén a <code>SzepPocket</code> paraméter használata szükséges.</p></td></tr></tbody></table>

#### Opcionális paraméterek

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="144">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>Currency</code></td><td>string<br><br>(3 karakter)</td><td><ul><li>HUF</li></ul></td><td><p>A fizetés devizaneme.<br></p><p>(Átadása nem befolyásolja a tranzakció devizanemét, mely <em>SZÉP Kártyánál</em> minden esetben HUF.)</p></td></tr><tr><td><code>OrderId</code></td><td>string<br><br>(255 karakter)</td><td>egyedi értékek<br><br>(kivéve e-mail címek, illetve személyes adatok)</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>UserId</code></td><td>string<br><br>(255 karakter)</td><td>egyedi értékek<br><br>(kivéve e-mail címek, illetve személyes adatok)</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, használata erősen javasolt.)</p></td></tr><tr><td><code>Language</code></td><td>string<br><br>(2 karakter)</td><td><ul><li>HU (alapért.)</li><li>EN</li><li>DE</li></ul></td><td>A fizetési felület nyelve.</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 (<a href="/pages/w2bB87azm3s2wK3Gnlgp">PSD2/SCA</a>).</td></tr><tr><td><code>SzepPocket</code> *</td><td>string</td><td><ul><li>foszamla (alapért.)</li><li>aktiv_magyarok</li></ul></td><td><p>A fizetéshez használt alszámla (<em>zseb</em>) azonosítója.</p><p>* A <code>SzepPocket</code> paramétert csak RawKHBSZEP <code>ProviderName</code> érték használata esetén lehet átadni.</p><p>KHBSZEP <code>ProviderName</code> használata esetén a <code>KhbCardPocketId</code> paraméter használata szükséges az <code>Extra</code> paraméteren keresztül.</p></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 szervizcsomag, 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 szervizcsomag, programnyelv, keretrendszer, modul, stb. verziószáma.</td></tr></tbody></table>

#### **Mintakód**

Tranzakció inicializálása `Init` 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 'Init | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Init' \
  --data 'json=
    {
        "StoreName":"sdk_test",
        "ProviderName":"KHBSZEP",
        "ResponseUrl":"https://demo.nevogate.com/response.php",
        "NotificationUrl":"https://www.notification.url/",
        "Amount":100,
        "Currency":"HUF",
        "OrderId":"TEST-ORDER-ID",
        "UserId":"TEST-USER-ID",
        "Extra":"eyJLaGJDYXJkUG9ja2V0SWQiOiIzIn0."
    }'
```

{% endcode %}

### API válasz paraméterek

Az `Init` 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>Paraméter</th><th width="134">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><p>Sikeres inicializálás:</p><ul><li>32 karakter hosszú md5 hash</li></ul><p>Sikertelen inicializálás:</p><ul><li>null</li></ul></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>Sikeres inicializálás:</p><ul><li>SUCCESSFUL</li></ul><p>Sikertelen inicializálás:</p><ul><li>InactiveStore</li><li>InactiveProvider</li><li>MissingParameter</li><li>MissingRemoteAddress</li><li>UnauthorizedAccess</li><li>UnauthorizedRemoteAddress</li><li>UnknownParameter</li><li>UnknownProvider</li><li>UnknownProviderForStore</li><li>UnknownStore</li><li>WrongApikey</li><li>WrongParameter</li><li>WrongProviderSettings</li></ul><p>Illetve további szolgáltató specifikus eredménykódok.</p></td><td><p>Jelzi a tranzakció inicializálás eredményét.<br><br>Sikertelen inicializálás esetén jelzi a hiba okát.<br></p><p>A felsoroltakon kívül további szolgáltató specifikus eredménykódokat is tartalmazhat.</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**

Sikeres inicializálásra adott válasz:

{% code overflow="wrap" %}

```php
{
    "TransactionId": "a17f60f6a671139d5a8b7c1943307b9b",
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "ResponseId": "3202109280600047703"
}
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.nevogate.com/egyszeri-fizetesek-one-time-payment/szep-kartya/tranzakcio-inicializalasa-init/k-and-h-specifikus-parameterek.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.