# 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 %}


---

# 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/ismetlodo-fizetes-recurring-payment/bankkartya-es-mobiltarca/kesobbi-terheles-ketlepcsos-fizetes/rakoevetkezo-fizetes-regisztralt-fizetoeszkoezzel/tranzakcio-inditasa-regisztralt-fizetoeszkoezzel-startrp.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.