Tranzakció inicializálása (Init) (fizetőeszköz-regisztrációhoz)
Működés
Használja az inicializálás (Init
) funkciót fizetőeszköz-regisztrációjához és egy új fizetési tranzakció kezdeményezésére. Az inicializálás során a kereskedő oldala átadja a tranzakció és a vásárló adatait rendszerünknek. Ennek hatására rendszerünk létrehoz egy új tranzakciós rekordot a kereskedőtől kapott adatok felhasználásával. Sikeres inicializálás esetén az új rekord mellett rendszerünk létrehoz egy új tranzakció azonosítót is (TransactionId
), majd visszaadja ezt az azonosítót a kereskedő oldalának.
Az inicializálás során figyeljen a következőkre:
Adja át az
AutoCommit
paramétert"false"
értékkel későbbi terhelés engedélyezéséhez.Adja meg a kereskedő rendszerében tárolt, egyedi
UserId
paramétert (megadása fizetőeszköz-regisztrációnál kötelező). Az egyes vásárlók az inicializálás során átadottUserId
paraméter segítségével azonosíthatók be (egy vásárló akár több fizetőeszközt is regisztrálhat).Adja át a
PaymentRegistration
és aPaymentRegistrationType
paramétereket a sikeres fizetőeszköz-regisztrációhoz.Használjon erős ügyfél-hitelesítést (PSD2/SCA) a vásárló adatainak átadásához. Erről a következő oldalon olvashat részletesebben: Erős ügyfél-hitelesítés (PSD2/SCA)
Tárolja le az
Init
kérésre visszaadott tranzakció azonosítót, mivel később ennek segítségével hivatkozhat az adott tranzakcióra.
Az inicializációban a fizetési szolgáltatók nem vesznek részt, ez a folyamat kizárólag a kereskedő oldala és a BIG FISH Payment Gateway rendszere között zajlik.
Mobilalkalmazás fejlesztésnél biztosítsa, hogy az inicializációra a szerver oldalon kerüljön sor. Biztonsági okokból az inicializáció nem történhet meg a mobilalkalmazásban.
API kérés paraméterek
Az API kérés általános információi
Művelet | HTTP kérés | Adatok |
---|---|---|
|
| method= |
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
opcionális paraméterek
Kötelező paraméterek
Paraméter | Típus | Érték | Leírás |
---|---|---|---|
| string | A BIG FISH Payment Gateway szerződésben kerül meghatározásra. | Rendszerünkben tárolt egyedi bolt azonosító. |
| string |
| A tranzakcióhoz kiválasztott fizetési szolgáltató. |
| 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. |
| string (255 karakter) | szabadon választható | |
| number | szabadon választható | Bruttó végösszeg amit a vásárló kifizet. (Magyar forint (HUF) esetén értéke egész szám.) |
| string |
| Jelzi, hogy a vásárló kétlépcsős fizetést indít és a megadott összeget a bank befoglalhatja a vásárló számláján. |
| 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. |
| boolean |
| Jelzi a fizetőeszköz-regisztráció indítását. |
| string (3 karakter) |
(a regisztrációra hivatkozó későbbi tranzakciók egykattintásos fizetéseket hoznak létre) | Meghatározza a (PSD2 szabványos) fizetőeszköz-regisztráció típusát. |
| string | egyedi értékek |
Opcionális paraméterek
Paraméter | Típus | Érték | Leírás |
---|---|---|---|
| string (3 karakter) |
| A fizetés devizaneme. (Értékei fizetési szolgáltatónként és szerződésenként eltérőek lehetnek.) |
| 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.) |
| string (2 karakter) |
(ISO 639-1 alapján) | A fizetési felület nyelve. |
| string | egyedi értékek | |
| string (32 karakter) | egyedi értékek | A kereskedő oldalán használt szervizcsomag, programnyelv, keretrendszer, modul, stb. megnevezése. |
| string (8 karakter) | verziószám | A kereskedő oldalán használt szervizcsomag, programnyelv, keretrendszer, modul, stb. verziószáma. |
Mintakód
Tranzakció inicializálása Init
kérés használatával:
API válasz paraméterek
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 |
---|---|---|---|
| string | Sikeres inicializálás:
Sikertelen inicializálás:
| A tranzakció azonosítója a BIG FISH Payment Gateway rendszerében. |
| 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. |
| string | leírás | Az egyes |
| integer | egyedi értékek | A válaszüzenet egyedi azonosítója a BIG FISH Payment Gateway rendszerében. |
Mintakód
Sikeres inicializálásra adott válasz:
Last updated