> 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/altalanos-informaciok/hitelesites-es-kapcsolodas/hitelesitesi-adatok-elokeszitese.md).

# Hitelesítési adatok előkészítése

Rendszerünk minden API hívást hitelesít a végrehajtás előtt. A kereskedő beazonosítására HTTP alapszintű hitelesítést használunk (HTTP Basic). A sikeres hitelesítéshez készítse elő a következő adatokat:

* `StoreName` és `ApiKey` páros
* `UserAgent` adatok

### **A `StoreName` és `ApiKey` páros előkészítése**

1. Kettősponttal kapcsolja össze a `StoreName` és `ApiKey` párost,
2. kódolja az így keletkezett párost Base64 kódolás segítségével,
3. helyezze el a kódot a HTTP kérés fejlécében (HTTP request header)**.**

#### Példa `StoreName` és `ApiKey` párosra

<table data-full-width="true"><thead><tr><th width="391">Művelet</th><th>Eredmény</th></tr></thead><tbody><tr><td><code>StoreName</code> érték</td><td>sdk_test</td></tr><tr><td><code>ApiKey</code> érték</td><td>86af3-80e4f-f8228-9498f-910ad</td></tr><tr><td>Kettősponttal összekapcsolt páros</td><td>sdk_test:86af3-80e4f-f8228-9498f-910ad</td></tr><tr><td>Az összekapcsolt páros Base64 kódolás után</td><td>c2RrX3Rlc3Q6ODZhZjMtODBlNGYtZjgyMjgtOTQ5OGYtOTEwYWQ=</td></tr><tr><td>Az így keletkezett HTTP kérés fejléce</td><td>authorization: Basic c2RrX3Rlc3Q6ODZhZjMtODBlNGYtZjgyMjgtOTQ5OGYtOTEwYWQ=</td></tr></tbody></table>

### **A `UserAgent` adatok előkészítése**

Minden API hívás esetén adja át `UserAgent` adatait, amit a következő elemekből állíthat össze:

* Hívott metódus neve
* Indított API kérés domain neve vagy IP címe
* Programozási nyelv neve
* Programozási nyelv verziószáma

#### Példa `UserAgent` adatokra

`Providers | merchant-store.com | PHP | 7.3.0`

### **Mintakódok és válaszok**

#### Mintakódok a hitelesítéshez

{% code overflow="wrap" %}

```php
curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --header 'authorization: Basic c2RrX3Rlc3Q6ODZhZjMtODBlNGYtZjgyMjgtOTQ5OGYtOTEwYWQ=' \
  --user-agent 'Providers | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Providers' \
  --data 'json=
    {
      "StoreName":"sdk_test"
    }'
```

{% endcode %}

vagy

{% code overflow="wrap" %}

```php
curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --user 'sdk_test:86af3-80e4f-f8228-9498f-910ad' \
  --user-agent 'Providers | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Providers' \
  --data 'json=
    {
      "StoreName":"sdk_test"
    }'
```

{% endcode %}

#### A fenti kérésekre adott válasz

{% code overflow="wrap" %}

```php
{
    "Data": [
        {
            "provider_name": "CIB",
            "provider_long_name": "CIB Bank"
        },
        {
            "provider_name": "OTP",
            "provider_long_name": "OTP Bank"
        },
        ...
    ],
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "ResponseId": "3202109280600047702"
}
```

{% endcode %}