> 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/bankkartya-es-mobiltarca/kesobbi-terheles-ketlepcsos-fizetes/rakoevetkezo-fizetes-regisztralt-fizetoeszkoezzel/tranzakcio-inditasa-regisztralt-fizetoeszkoezzel-startrp.md).

# Tranzakció indítása regisztrált fizetőeszközzel (StartRP)

### Működés

A rákövetkező tranzakció befejezéséhez a sikeres inicializáció után egy sikeres tranzakció indítás szükséges. Ebben az esetben használja a `StartRP` hívást a tranzakció indításához.

{% hint style="info" %}
Rákövetkező fizetések esetén a tranzakció eredményét a `StartRP` hívás adja vissza, ezért itt nincs szükség Result hívás indítására.

Amennyiben a `StartRP` hívásra visszaadott válaszban a tranzakció státusza még PENDING, abban az esetben a kereskedő rendszerét a megadott `ResponseUrl` és `NotificationUrl` címeken értesítjük, amint rendszerünk megkapta a fizetési szolgáltatótól a tranzakció végstátuszát. Ebben az esetben szükséges a `Result` hívás indítása a kereskedő rendszeréből.
{% endhint %}

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

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

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

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

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

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="105">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>32 karakter hosszú md5 hash</td><td>A tranzakció azonosítója, melyet az <code>InitRP</code> hívás során generál a <em>Nevogate</em> rendszere.</td></tr></tbody></table>

#### **Mintakód**

Rákövetkező tranzakció indítása referencia tranzakció segítségével, `StartRP` 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 'StartRP | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=StartRP' \
  --data 'json=
    {
        "TransactionId":"90866b50774d8341be49c1aea1ede5a6"
    }'
```

{% endcode %}

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

A `StartRP` 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="344">Paraméter</th><th width="133">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>egyedi értékek</td><td>Rendszerünkben tárolt egyedi boltazonosító.</td></tr><tr><td><code>ProviderName</code></td><td>string</td><td>egyedi értékek</td><td>A tranzakcióhoz kiválasztott fizetési szolgáltató.</td></tr><tr><td><code>TransactionId</code></td><td>string</td><td>32 karakter hosszú md5 hash</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>A tranzakció státusza lehet:</p><ul><li>SUCCESSFUL</li><li>PENDING</li><li>ERROR</li><li>TIMEOUT</li></ul><p>Hiba esetén a következő eredménykódok jelölik a hiba okát:</p><ul><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>UnknownTransaction</li><li>WrongApikey</li><li>WrongReferenceTransactionStatus</li><li>WrongTransactionStatus</li></ul></td><td><p>Jelzi a tranzakció eredményét.<br><br>A tranzakció státuszokról a következő oldalon olvashat további információkat: <a href="/pages/yzo9U4RLeMGLusg6Mrfl">Tranzakció státuszok</a></p><p>Sikertelen inicializálás esetén 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>Anum</code></td><td>string</td><td>egyedi értékek</td><td><p>A tranzakció engedélyszáma a fizetési szolgáltató rendszerében.<br></p><p>(Csak bizonyos szolgáltatók esetén.)</p></td></tr><tr><td><code>Amount</code></td><td>number</td><td>egyedi értékek</td><td><p>A tranzakció bruttó végösszege.<br></p><p>(Az összeg amit a vásárló kifizetett.)</p></td></tr><tr><td><code>Currency</code></td><td>string<br><br>(3 karakter)</td><td><ul><li>HUF</li><li>EUR</li><li>USD</li><li>...</li></ul></td><td><p>A tranzakció 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>OrderId</code></td><td>string</td><td>egyedi értékek</td><td><p>A megrendelés azonosítója a kereskedő áruházában.<br></p><p>(Az inicializáció során átadott <code>OrderId</code>.)</p></td></tr><tr><td><code>UserId</code></td><td>string</td><td>szabadon választható<br><br>(kivéve e-mail címek és személyes adatok)</td><td><p>A vásárló azonosítója a kereskedő áruházában.<br></p><p>(Az inicializáció során átadott <code>UserId</code>.)</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><li>...</li></ul></td><td>A fizetési felület nyelve.</td></tr><tr><td><code>ProviderTransactionId</code></td><td>string</td><td>egyedi értékek</td><td>A tranzakció azonosítója a fizetési szolgáltató rendszerében.</td></tr><tr><td><code>AutoCommit</code></td><td>string</td><td><ul><li>“true”</li><li>“false”</li></ul></td><td><p>Jelzi, hogy a bank azonnal vagy később hajtja végre a tranzakciót.</p><p>(Az inicializáció során beállított <code>AutoCommit</code> értéke.)</p></td></tr><tr><td><code>CommitState</code></td><td>string</td><td><ul><li>PENDING</li><li>APPROVED</li><li>DECLINED</li></ul></td><td><p>Kétlépcsős tranzakció esetén jelzi a tranzakciós összeg állapotát.<br></p><p>• PENDING: az összeg zárolásra került, de még terhelésre vár (tranzakció lezárással)</p><p>• APPROVED: a végleges összeg beterhelése megtörtént</p><p>• DECLINED: a zárolt összeg feloldásra került (nem történt terhelés)</p></td></tr><tr><td><code>PaywallPaymentName</code></td><td>string<br><br>(36 karakter)</td><td><ul><li>null</li><li>UUID</li></ul></td><td>A tranzakció <em>PayWall</em> azonosítója (kizárólag a <em>PayWall</em> segítségével indított fizetések esetén).</td></tr><tr><td><code>PaywallRecurringPaymentEnabled</code></td><td>string</td><td><ul><li>"true"</li><li>"false"</li></ul></td><td>Jelzi a vásárló hozzájárulását, hogy a kereskedő a jövőben az adott tranzakcióra hivatkozva újabb, ismétlődő tranzakciókat indíthasson (kizárólag a <em>PayWall</em> segítségével indított fizetések esetén).</td></tr><tr><td><code>PaymentRegistrationType</code></td><td>string</td><td>MIT</td><td>Jelzi a fizetőeszköz regisztráció típusát.</td></tr><tr><td><code>SzepPocket</code></td><td>string</td><td><ul><li>null</li></ul></td><td>A paraméter ismétlődő fizetések esetén nincs használatban.</td></tr><tr><td><code>ProviderResultCode</code></td><td>string</td><td><p>egyedi értékek, melyek csak az alábbi fizetési szolgáltatóktól származhatnak (szolgáltató és hozzá tartozó kód párosként felsorolva):</p><ul><li>Barion2 (ErrorCode)</li><li>Borgun2 (ActionCode)</li><li>GP (PRCODE)</li><li>KHB (paymentStatus)</li><li>OTPSimple (resultCode / errorCodes)</li><li>PayURest (cardResponseCode)</li><li>Saferpay (ErrorName)</li></ul></td><td>A fizetési szolgáltató rendszeréből származó elsődleges eredmény- vagy hibakód.</td></tr><tr><td><code>ProviderResultCode2</code></td><td>string</td><td><p>egyedi értékek, melyek csak az alábbi fizetési szolgáltatóktól származhatnak (szolgáltató és hozzá tartozó kód párosként felsorolva):</p><ul><li>GP (SRCODE)</li><li>Saferpay (ProcessorResult)</li></ul></td><td>A fizetési szolgáltató rendszeréből származó másodlagos eredmény- vagy hibakód.</td></tr><tr><td><code>Created</code></td><td>string</td><td>dátum</td><td>A tranzakció létrehozásának dátuma.</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 rákövetkező tranzakció indítására adott válasz:

{% code overflow="wrap" %}

```php
{
    "StoreName": "sdk_test",
    "ProviderName": "OTPSimple",
    "TransactionId":"90866b50774d8341be49c1aea1ede5a6",
    "ResultCode":"SUCCESSFUL",
    "ResultMessage":"Sikeres tranzakció",
    "Anum":"",
    "Amount": "200",
    "Currency": "HUF",
    "OrderId":"TEST-ORDER-ID-REG",
    "UserId":"TEST-USER-ID-REG",
    "Language": "HU",
    "ProviderTransactionId":"99104804",
    "AutoCommit":"true",
    "CommitState":"APPROVED",
    "PaywallPaymentName": null,
    "PaywallRecurringPaymentEnabled": "false",
    "PaymentRegistrationType": "MIT",
    "SzepPocket": null,
    "ProviderResultCode": "000",
    "ProviderResultCode2": null,
    "Created": "2020-03-14 11:19:07",
    "ResponseId": "3202109280600047719"
}
```

{% endcode %}