URL Értesítés

Működés
Használja a NotificationUrl paramétert, hogy automatikusan értesüljön a tranzakciók státuszának változásáról. Az inicializáció (Init) során adja át az értesítési URL címet a NotificationUrl paraméterben. Rendszerünk ezt a címet hívja meg a tranzakció státuszának megváltozásakor.
Rendszerünk legfeljebb 5 alkalommal kísérli meg a megadott értesítési URL hívását, amíg a hívásra HTTP 200 választ nem kap. Az értesítés a tranzakció részletes adatait tartalmazza JSON formátumban (a Details hívás eredményének megfelelően), amit application/json típusként küldünk, így az adat a raw request body-ból nyerhető ki.
Jelezze vissza rendszerünk számára, hogy a kereskedő oldala értesült a tranzakció eredményéről. Ehhez indítson egy Result kérést minden rendszerünktől visszaérkező NotificationUrl hívás után. Result kérés hiányában a tranzakció “megválaszolhatatlan” állapotot kap a PayAdmin felületén.
A NotificationUrl átadása minden tranzakció inicializáció során kötelező.
A JSON formátumú értesítésben található paraméterek kis kezdőbetűkkel szerepelnek. Ezzel ellentétben a tranzakció részletes adatainak lekérdezésére (Details hívásra) adott válasz paraméterei nagy kezdőbetűvel rendelkeznek.
Példa (az URL értesítés beállítására teszt környezetben)
curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --user 'sdk_test:86af3-80e4f-f8228-9498f-910ad' \
  --user-agent 'Init | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Init' \
  --data 'json=
    {
        "StoreName":"sdk_test",
        "ProviderName":"Borgun2",
        "ResponseUrl":"https://demo.paymentgateway.hu/response.php",
        "Amount":100,
        "Currency":"HUF",
        "OrderId":"BF-TEST-ORDER",
        "UserId":"BF-TEST-USER",
        "NotificationUrl":"https://merchant.notification.url"
    }'
Tranzakció indítása (Start)
Tranzakció eredményének lekérdezése (Result)
Last modified 2mo ago