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

Művelet	Eredmény
StoreName érték	sdk_test
ApiKey érték	86af3-80e4f-f8228-9498f-910ad
Kettősponttal összekapcsolt páros	sdk_test:86af3-80e4f-f8228-9498f-910ad
Az összekapcsolt páros Base64 kódolás után	c2RrX3Rlc3Q6ODZhZjMtODBlNGYtZjgyMjgtOTQ5OGYtOTEwYWQ=
Az így keletkezett HTTP kérés fejléce	authorization: Basic c2RrX3Rlc3Q6ODZhZjMtODBlNGYtZjgyMjgtOTQ5OGYtOTEwYWQ=

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

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"
    }'

vagy

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"
    }'

A fenti kérésekre adott válasz

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