Tranzakció inicializálása (Init) (regisztrált fizetőeszközzel)
Last updated
Was this helpful?
Last updated
Was this helpful?
Használja az inicializálás (Init) funkciót rákövetkező fizetés létrehozásához (amennyiben a vásárló már rendelkezik legalább egy regisztrált fizetőeszközzel). Az inicializálás során a kereskedő oldala átadja a referencia tranzakció azonosítóját, illetve az aktuális 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 meg a kereskedő rendszerében tárolt, egyedi UserId paramétert. Az egyes vásárlók az inicializálás során átadott UserId paraméter segítségével azonosíthatók be. A rákövetkező fizetéshez átadott UserId értéke meg kell egyezzen a referencia tranzakció során átadott UserId értékével.
Adja át a PaymentRegistration, a OneClickPayment és a ReferenceTransactionId paramétereket az egykattintásos (one-click) fizetéshez.
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:
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.
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.
Init
POST
method=Init
json={JSON encode-olt paraméterek}
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
RawMBHSZEP
RawOTPSZEP
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ó
Amount
number
szabadon választható
Bruttó végösszeg amit a vásárló kifizet. Értéke egész szám lehet.
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.
PaymentRegistration
boolean
false
Jelzi, hogy ebben az esetben nem történik fizetőeszköz-regisztráció.
OneClickPayment
boolean
true
Jelzi, hogy a tranzakció egykattintásos (one-click) fizetést eredményez.
ReferenceTransactionId
string
32 karakter hosszú md5 hash
A fizetőeszköz-regisztrációhoz kapcsolódó tranzakció azonosítója a BIG FISH Payment Gateway rendszerében.
Info *
string
egyedi értékek
Currency
string (3 karakter)
HUF
A fizetés devizaneme.
(Értékei fizetési szolgáltatónként és szerződésenként eltérőek lehetnek.)
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.)
Language
string (2 karakter)
HU (alapért.)
EN
DE
A fizetési felület nyelve.
Extra
string
egyedi értékek
SzepPocket
string
foszamla (alapért.)
aktiv_magyarok
otthonfelujitas
A fizetéshez használt alszámla (zseb) azonosítója.
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.
Rákövetkező tranzakció inicializálása Init kérés használatával:
Az Init kérés eredményét JSON formában válaszoljuk meg. A válasz a következő paramétereket tartalmazza:
TransactionId
string
Sikeres inicializálás:
32 karakter hosszú md5 hash
Sikertelen inicializálás:
null
A tranzakció azonosítója a BIG FISH Payment Gateway rendszerében.
ResultCode
string
Sikeres inicializálás:
SUCCESSFUL
Sikertelen inicializálás:
InactiveStore
InactiveProvider
MissingParameter
MissingRemoteAddress
UnauthorizedAccess
UnauthorizedRemoteAddress
UnknownParameter
UnknownProvider
UnknownProviderForStore
UnknownStore
WrongApikey
WrongParameter
WrongProviderSettings
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:
Rendszerünk ezen a címen értesíti a kereskedőt a tranzakció státuszának változásáról ().
A vásárlás és a vásárló adatai az erős ügyfél-hitelesítéshez (). * OTP SZÉP Kártyával indított egykattintásos tranzakciók létrehozásánál kötelező az erős-ügyfélhitelesítés használata (PSD2/SCA). Ez a SZÉP Kártya szolgáltató elvárja a vásárló email címének átadását az általános vásárlói adatok objektumban.
Kiegészítő vagy szolgáltató specifikus adatok ().