# Tranzakció részletes adatainak lekérdezése (Details)

### Működés

Használja a `Details` hívást a tranzakció részletes adatainak lekérdezéséhez. Míg a `Result` hívásra adott válasz csupán a tranzakció alapadatait hordozza, a `Details` hívás további részletes információkat is tartalmaz az adott tranzakcióról (pl. szolgáltató specifikus adatokat).

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

{% hint style="warning" %}
A fizetési tranzakcióhoz kapcsolódó adatok közül a kommunikációs naplóbejegyzések (log) a fizetési tranzakció létrehozását követő 2 évig, míg minden egyéb adat a szolgáltatási szerződés megszűnéséig érhető el.
{% endhint %}

### **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>Details</code></td><td><code>POST</code></td><td>method=<code>Details</code><br><br>json={JSON encode-olt paraméterek}</td></tr></tbody></table>

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

A `Details` kérés a következő paraméterekkel rendelkezik (**a `TransactionId` átadása kötelező**)

<table data-full-width="true"><thead><tr><th>Paraméter</th><th width="111">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 a <em>Nevogate</em> rendszerében.</td></tr><tr><td><code>GetRelatedTransactions</code></td><td>boolean</td><td><ul><li>true</li><li>false (alapért.)</li></ul></td><td>Olyan korábbi tranzakciók részletes adatainak lekérése, melyek <code>OrderId</code> paramétere megegyezik az aktuális tranzakció <code>OrderId</code> értékével.</td></tr><tr><td><code>GetInfoData</code></td><td>boolean</td><td><ul><li>true</li><li>false (alapért.)</li></ul></td><td><p>Kérés a vásárlásra vonatkozó <code>Info</code> adatok visszaadására.<br></p><p>(<code>Init</code>, <code>InitRP</code> vagy <code>PaymentLinkCreate</code> hívások során átadott vásárlási adatok esetén.)</p></td></tr></tbody></table>

#### **Mintakód**

A tranzakció részletes adatainak lekérése `Details` 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 'Details | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Details' \
  --data 'json=
    {
        "TransactionId":"a4d6f6f27f2116da21da62d705dbd7ef",
        "GetRelatedTransactions":false,
        "GetInfoData":false
    }'
```

{% endcode %}

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

Az `Details` 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="248">Paraméter</th><th width="129">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>CommonData</code></td><td>JSON object</td><td>egyedi értékek</td><td><p>A tranzakció alapadatai.<br></p><p>(A <code>Result</code> hívás során is visszaadott adatok.)</p></td></tr><tr><td><code>ProviderSpecificData</code></td><td>JSON object</td><td>egyedi értékek</td><td>Szolgáltató specifikus kiegészítő adatok.</td></tr><tr><td><code>RelatedTransactions</code></td><td>JSON object</td><td>egyedi értékek</td><td>Olyan korábbi tranzakciók adatai melyek <code>OrderId</code> paramétere megegyezik az aktuális tranzakció <code>OrderId</code> értékével.</td></tr><tr><td><code>InfoData</code></td><td>JSON object</td><td>egyedi értékek</td><td>Az <code>Info</code> objektum adatai.</td></tr><tr><td><code>ResultCode</code></td><td>string</td><td><p>Az API kérés eredménye lehet:</p><ul><li>SUCCESSFUL</li></ul><p>Hiba esetén a következő eredménykódok jelölik a hiba okát:</p><ul><li>InactiveStore</li><li>MissingParameter</li><li>MissingRemoteAddress</li><li>UnauthorizedAccess</li><li>UnauthorizedRemoteAddress</li><li>UnknownStore</li><li>UnknownTransaction</li><li>WrongApikey</li></ul><p>(Továbbá a szolgáltatókra vonatkozó specifikus eredménykódok is megjelenhetnek itt.)</p></td><td><p>Jelzi az API kérés eredményét:</p><ul><li>SUCCESSFUL: az API kérés sikeres.</li></ul></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>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>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 `Details` kérésre adott válasz (formázást követően):

{% code overflow="wrap" %}

```php
{
    "CommonData":
    {
        "StoreName": "sdk_test",
        "ProviderName": "RawMBHSZEP",
        "TransactionId": "992c8e75435e6d4dfdf6415f0714cae8",
        "ResultCode": "SUCCESSFUL",
        "ResultMessage": "Sikeres tranzakció",
        "Anum": "006761",
        "Amount": "100",
        "Currency": "HUF",
        "OrderId": "TEST-ORDER-ID",
        "UserId": "TEST-USER-ID",
        "Language": "HU",
        "ProviderTransactionId": "tr_tzftXkC-fcwaVPiAVVNgotmIhY_QXydL",
        "AutoCommit": "true",
        "CommitState": "APPROVED",
        "PaywallPaymentName": null,
        "PaywallRecurringPaymentEnabled": "false",
        "PaymentRegistrationType": "CIT",
        "SzepPocket": "foszamla",
        "ProviderResultCode": "000",
        "ProviderResultCode2": null,
        "PaymentLinkName": null,
        "Created": "2020-03-14 11:19:07",
        "ResponseId": "3202109280600047703"
    },
    "ProviderSpecificData":
    {
        ...
        "Amount": "100",
        "Currency": "HUF",
        "Language": "HU",
        "OrderId": "TEST-ORDER-ID",
        "UserId": "TEST-USER-ID",
        "ResponseUrl": "https://demo.nevogate.com/response.php",
        "NotificationUrl": null,
        "MaxNotificationSendAttempts": 0,
        "NotificationSendAttempts": 0,
        "NotificationSendSuccess": 0,
        "Extra": null,
        "AutoCommit" : "0",
        "CommitState": "1",
        "HasRefund": "0",
        "Created": "2020-03-14 11:19:07",
        "LastModified": "2020-03-14 11:19:07",
        "InvoiceDate": null,
        "GatewayPaymentPage": null,
        "ModuleName": null,
        "ModuleVersion": null,
        "StoreProviderId": "3103",
        "Error": null,
        "ResultMessage": null
    },
    "RelatedTransactions": null,
    "InfoData": null,
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "ProviderName": "RawMBHSZEP",
    "ResponseId": "3202109280600047706"
}
```

{% endcode %}