Comment on page
K&H specifikus paraméterek
A K&H SZÉP Kártyás fizetésnél az alszámla (zseb) adatai az
Extra
paraméterben kerülnek átadásra a KhbCardPocketId
változó segítségével.2023. január 9-től a SZÉP Kártyához tartozó alszámlák (zsebek) összevonásra kerültek a szálláshely alszámla alatt. A határozat szerint minden SZÉP Kártyás fizetés a szálláshely alszámlából kerül levonásra. Ennek értelmében a fizetési szolgáltatók jelenleg minden SZÉP Kártyás terhelést a szálláshely alszámlára irányítanak át. Ennek ellenére a SZÉP Kártyás tranzakciók indításában nem történt technikai változás, így ezek indításához továbbra is meg kell adni egy alszámla-azonosítót.
Az API kérésekhez kapcsolódó paramétereket két táblázatba soroljuk fel a könnyebb átláthatóság kedvéért. Természetesen az egyes paraméterek megjelenhetnek ugyanabban az API kérésben.
Az API paraméterek felosztása a következő:
- kötelező paraméterek
Extra
paraméterek
- opcionális paraméterek
Paraméter | Típus | Érték | Leírás |
---|---|---|---|
StoreName | string | A BIG FISH Payment Gateway szerződésben kerül meghatározásra. | Rendszerünkben tárolt egyedi bolt azonosító. |
ProviderName | string | KHBSZEP | A tranzakcióhoz kiválasztott fizetési szolgáltató. |
ResponseUrl | string
(255 karakter) | szabadon választható | Visszatérési URL: tranzakciót követően, rendszerünk erre a címre irányítja vissza a vásárlót. |
NotificationUrl | string
(255 karakter) | szabadon választható | Rendszerünk ezen a címen értesíti a kereskedőt a tranzakció státuszának változásáról (URL értesítés). |
Amount | number | szabadon választható (egész szám) | Bruttó végösszeg amit a vásárló kifizet. |
Extra | string | KhbCardPocketId változó | A fizetéshez használt alszámla (zseb) átadásának módja.
Részletekért látogassa meg a következő oldalt: K&H Extra paraméterek) |
Paraméter | Típus | Érték | Leírás |
---|---|---|---|
Currency | string
(3 karakter) | HUF | A fizetés devizaneme.
(Átadása nem befolyásolja a tranzakció devizanemét, mely SZÉP Kártyánál minden esetben HUF.) |
OrderId | string
(255 karakter) | egyedi értékek
(kivéve e-mail címek, illetve személyes adatok) | A megrendelés azonosítója a kereskedő áruházában. (Lehetővé teszi a tranzakció visszakeresését, használata erősen javasolt.) |
UserId | string
(255 karakter) | egyedi értékek
(kivéve e-mail címek, illetve személyes adatok) | A vásárló azonosítója a kereskedő áruházában.
(Lehetővé teszi a tranzakció visszakeresését, használata erősen javasolt.) |
Language | string
(2 karakter) |
(ISO 639-1 alapján) | A fizetési felület nyelve. |
Info | string | egyedi értékek | |
ModuleName | string
(32 karakter) | egyedi értékek | A kereskedő oldalán használt szervizcsomag, programnyelv, keretrendszer, modul, stb. megnevezése. |
ModuleVersion | string
(8 karakter) | verziószám | A kereskedő oldalán használt szervizcsomag, programnyelv, keretrendszer, modul, stb. verziószáma. |
Tranzakció inicializálása
Init
kérés használatával: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":"KHBSZEP",
"ResponseUrl":"https://demo.paymentgateway.hu/response.php",
"NotificationUrl":"https://www.notification.url/bfpg",
"Amount":100,
"Currency":"HUF",
"OrderId":"BF-TEST-ORDER",
"UserId":"BF-TEST-USER",
"Extra":"eyJLaGJDYXJkUG9ja2V0SWQiOiIzIn0."
}'
Az
Init
kérés eredményét JSON formában válaszoljuk meg. A válasz a következő paramétereket tartalmazza:Paraméter | Típus | Érték | Leírás |
---|---|---|---|
TransactionId | string | Sikeres inicializálás:
Sikertelen inicializálás:
| A tranzakció azonosítója a BIG FISH Payment Gateway rendszerében. |
ResultCode | string | Sikeres inicializálás:
Sikertelen inicializálás:
Illetve további szolgáltató specifikus eredménykódok. | Jelzi a tranzakció inicializálás eredményét.
Sikertelen inicializálás esetén jelzi a hiba okát.
A felsoroltakon kívül további szolgáltató specifikus eredménykódokat is tartalmazhat. |
ResultMessage | string | leírás | Az egyes ResultCode értékek szöveges magyarázata. |
ResponseId | integer | egyedi értékek | A válaszüzenet egyedi azonosítója a BIG FISH Payment Gateway rendszerében. |
Sikeres inicializálásra adott válasz:
{
"TransactionId": "a17f60f6a671139d5a8b7c1943307b9b",
"ResultCode": "SUCCESSFUL",
"ResultMessage": null,
"ResponseId": "3202109280600047703"
}
Last modified 2mo ago