Tranzakció indítása regisztrált fizetőeszközzel (StartRP)
Last updated
Last updated
A rákövetkező tranzakció befejezéséhez a sikeres inicializáció után egy sikeres tranzakció indítás szükséges. Ebben az esetben használja a StartRP hívást a tranzakció indításához.
Rákövetkező fizetések esetén a tranzakció eredményét a StartRP hívás adja vissza, ezért itt nincs szükség Result hívás indítására.
Amennyiben a StartRP hívásra visszaadott válaszban a tranzakció státusza még PENDING, abban az esetben a kereskedő rendszerét a megadott ResponseUrl és NotificationUrl címeken értesítjük, amint rendszerünk megkapta a fizetési szolgáltatótól a tranzakció végstátuszát. Ebben az esetben szükséges a Result hívás indítása a kereskedő rendszeréből.
| Művelet | HTTP kérés | Adatok |
|---|---|---|
| Paraméter | Típus | Érték | Leírás |
|---|---|---|---|
Rákövetkező tranzakció indítása referencia tranzakció segítségével, StartRP kérés használatával:
A StartRP kérés eredményét JSON formában válaszoljuk meg. A válasz a következő paramétereket tartalmazza:
Sikeres rákövetkező tranzakció indítására adott válasz:
| Paraméter | Típus | Érték | Leírás |
|---|---|---|---|
StartRP
POST
method=StartRP
json={JSON encode-olt paraméterek}
TransactionId
string
32 karakter hosszú md5 hash
A tranzakció azonosítója, melyet az InitRP hívás során generál a BIG FISH Payment Gateway rendszere.
StoreName
string
egyedi értékek
Rendszerünkben tárolt egyedi boltazonosító.
ProviderName
string
egyedi értékek
A tranzakcióhoz kiválasztott fizetési szolgáltató.
TransactionId
string
32 karakter hosszú md5 hash
A tranzakció azonosítója a BIG FISH Payment Gateway rendszerében.
ResultCode
string
A tranzakció státusza lehet:
SUCCESSFUL
PENDING
ERROR
TIMEOUT
Hiba esetén a következő eredménykódok jelölik a hiba okát:
InactiveStore
InactiveProvider
MissingParameter
MissingRemoteAddress
UnauthorizedAccess
UnauthorizedRemoteAddress
UnknownReferenceTransaction
UnknownStore
UnknownTransaction
WrongApikey
WrongReferenceTransactionStatus
WrongTransactionStatus
Jelzi a tranzakció eredményét. A tranzakció státuszokról a következő oldalon olvashat további információkat: Tranzakció státuszok
Sikertelen inicializálás esetén jelzi a hiba okát.
ResultMessage
string
leírás
Az egyes ResultCode értékek szöveges magyarázata.
Anum
string
egyedi értékek
A tranzakció engedélyszáma a fizetési szolgáltató rendszerében.
(Csak bizonyos szolgáltatók esetén.)
Amount
number
egyedi értékek
A tranzakció bruttó végösszege.
(Az összeg amit a vásárló kifizetett.)
Currency
string (3 karakter)
HUF
EUR
USD
...
A tranzakció devizaneme.
(Értékei fizetési szolgáltatónként és szerződésenként eltérőek lehetnek.)
OrderId
string
egyedi értékek
A megrendelés azonosítója a kereskedő áruházában.
(Az inicializáció során átadott OrderId.)
UserId
string
szabadon választható (kivéve e-mail címek és személyes adatok)
A vásárló azonosítója a kereskedő áruházában.
(Az inicializáció során átadott UserId.)
Language
string (2 karakter)
HU (alapért.)
EN
DE
...
A fizetési felület nyelve.
ProviderTransactionId
string
egyedi értékek
A tranzakció azonosítója a fizetési szolgáltató rendszerében.
AutoCommit
string
“true”
“false”
Jelzi, hogy a bank azonnal vagy később hajtja végre a tranzakciót.
(Az inicializáció során beállított AutoCommit értéke.)
CommitState
string
PENDING
APPROVED
DECLINED
Kétlépcsős tranzakció esetén jelzi a tranzakciós összeg állapotát.
• PENDING: az összeg zárolásra került, de még terhelésre vár (tranzakció lezárással)
• APPROVED: a végleges összeg beterhelése megtörtént
• DECLINED: a zárolt összeg feloldásra került (nem történt terhelés)
PaywallPaymentName
string (36 karakter)
null
UUID
A tranzakció PayWall azonosítója (kizárólag a PayWall segítségével indított fizetések esetén).
PaywallRecurringPaymentEnabled
string
"true"
"false"
Jelzi a vásárló hozzájárulását, hogy a kereskedő a jövőben az adott tranzakcióra hivatkozva újabb, ismétlődő tranzakciókat indíthasson (kizárólag a PayWall segítségével indított fizetések esetén).
PaymentRegistrationType
string
MIT
Jelzi a fizetőeszköz regisztráció típusát.
SzepPocket
string
null
A paraméter ismétlődő fizetések esetén nincs használatban.
ProviderResultCode
string
egyedi értékek, melyek csak az alábbi fizetési szolgáltatóktól származhatnak (szolgáltató és hozzá tartozó kód párosként felsorolva):
Barion2 (ErrorCode)
Borgun2 (ActionCode)
CIB (RC)
GP (PRCODE)
KHB (paymentStatus)
OTPSimple (resultCode / errorCodes)
PayURest (cardResponseCode)
Saferpay (ErrorName)
VivaWallet (statusId)
A fizetési szolgáltató rendszeréből származó elsődleges eredmény- vagy hibakód.
ProviderResultCode2
string
egyedi értékek, melyek csak az alábbi fizetési szolgáltatóktól származhatnak (szolgáltató és hozzá tartozó kód párosként felsorolva):
GP (SRCODE)
Saferpay (ProcessorResult)
VivaWallet (EventId / ResponseEventId)
A fizetési szolgáltató rendszeréből származó másodlagos eredmény- vagy hibakód.
Created
string
dátum
A tranzakció létrehozásának dátuma.
ResponseId
integer
egyedi értékek
A válaszüzenet egyedi azonosítója a BIG FISH Payment Gateway rendszerében.