Könyvelés támogatás és tranzakciók pénzügyi elszámolása (PayBook)
Last updated
Was this helpful?
Last updated
Was this helpful?
A PayBook szolgáltatás használatával lekérdezheti egy virtuális terminálon keletkezett tranzakciók pénzügyi kimutatásait. A PayBook azonosítja a kereskedő és a fizetési szolgáltató között létrejött pénzügyi elszámoláshoz tartozó tranzakciókat rendszerünkben, ezzel megkönnyíti a rendszerünkben keletkezett tranzakciók pénzügyi elszámolását.
Felhívjuk a figyelmét, hogy egy adott nap kimutatásait csupán egy nappal később töltjük le a fizetési szolgáltatóktól. A letöltést és feldolgozást rendszerünk automatikusan végrehajtja, amennyiben az adott fizetési szolgáltató biztosítja a kimutatások elérését (pl. FTP tárhelyen, vagy API-n keresztül). A feldolgozás biztos lefutásához a kereskedőnek célszerű a lekérdezés pillanatához képest legalább 2 nappal korábbi kimutatásokat lekérdezni.
A kiegészítő szolgáltatásokat, így a PayBook használatát is külön kell kérelmezni ügyfélszolgálatunkon, amit a következő címre írt üzenettel tehet meg:
A pénzügyi kimutatások lekérdezése a következő fizetési szolgáltatók esetén érhető el:
Teya RPG
CIB Bank
Global Payments
K&H SZÉP Kártya (manuális feltöltés)
MBH SZÉP Kártya (manuális feltöltés)
OTP SZÉP Kártya
PayPal REST
PayU REST
SimplePay
Viva Wallet (manuális feltöltés)
Worldline - Saferpay
Egyes szolgáltatók esetén a kimutatásokat kizárólag manuális feltöltés után tudjuk feldolgozni. Manuális feltöltéshez előbb töltse le a kimutatást az adott fizetési szolgáltató felületéről (ha azt nem kapta meg email-ben), majd töltse fel ezeket a kimutatásokat a PayBook admin felületén, amit a következő hivatkozáson is elérhet:
PayBook - Kimutatás feltöltése (tesztrendszer)
PayBook - Kimutatás feltöltése (éles rendszer)
A manuális feltöltéshez kövesse ezeket a lépéseket:
Válassza ki a kimutatáshoz tartozó boltot, szolgáltatót és a terminált a legördülő menükből,
adja meg meg a fizetési szolgáltatótól letöltött kimutatás létrehozásának idejét,
majd válassza ki a megfelelő kimutatást és töltse fel rendszerünkbe.
A korábban feltöltött és feldolgozott kimutatások megtekintésére is lehetőség nyílik az PayBook admin felületen. A megfelelő szűréshez a fenti lépéseken túl ki kell választani a pénznemet és opcionálisan megadható egy kimutatáshoz tartozó banki utalási közlemény is. A kimutatások áttekintését erről a hivatkozásról is elérheti:
Használja a Settlement
funkciót az adott terminálon létrejött pénzügyi kimutatások lekérdezéséhez.
Settlement
POST
method=Settlement
json={JSON encode-olt paraméterek}
Az API kérésekhez kapcsolódó paramétereket két táblázatban 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
StoreName
string
A BIG FISH Payment Gateway szerződésben kerül meghatározásra.
Meghatározza a lekérdezett kimutatásokhoz tartozó kereskedői boltot.
ProviderName
string
Borgun2 (Teya RPG)
CIB
GP (Global Payments)
KHBSZEP
MKBSZEP
OTP
OTPSimple (SimplePay)
PayPalRest
PayURest
RawMBHSZEP
RawOTPSZEP
Saferpay (Worldline)
VivaWallet
A kimutatáshoz/elszámoláshoz kiválasztott fizetési szolgáltató.
TerminalId
string
egyedi értékek
A kereskedő virtuális termináljának (VPOS) egyedi azonosítója.
TransactionCurrency
string (3 karakter)
HUF
EUR
USD
...
Az adott terminálhoz beállított devizanem (azonos azzal a devizanemmel amiben a tranzakció létrejött).
Limit
number
maximum 1000 tétel
Az adott lekérdezés során visszaadott tételek maximális száma.
(Opcionálisan használhatja az Offset
paramétert további tételek lekérdezésére, amennyiben az aktuális lekérdezéshez több tétel tartozik, mint a Limit
paraméterben megadott érték.)
Felhívjuk figyelmét, hogy a következő paraméterek valamelyikének megadása opcionálisan kötelező:
SettlementDate
TransferNotice
SettlementBatchId
SettlementDate
string (10 karakter)
dátum, a következő formátumban:
ÉÉÉÉ-HH-NN
A kimutatás létrehozásának ideje.
Megadása kötelező, amennyiben a TransferNotice
és a SettlementBatchId
paraméterek egyike sem kerül átadásra.
TransferNotice
string
egyedi értékek
(SimplePay esetén, az utalási közleményben található, első szóközt követő rész.)
A bank utalási közleménye.
Megadása kötelező, amennyiben a SettlementDate
és a SettlementBatchId
paraméterek egyike sem kerül átadásra.
SettlementBatchId
number (8 karakter)
egyedi érték
Köteg azonosító.
Megadása kötelező, amennyiben a SettlementDate
és a TransferNotice
paraméterek egyike sem kerül átadásra.
GetBatches
boolean
true (alapért.)
false
Meghatározza, hogy a lekérdezett válasz tartalmazzon vagy ne tartalmazzon köteg adatokat.
GetItems
boolean
true (alapért.)
false
Meghatározza, hogy a lekérdezett válasz tartalmazzon vagy ne tartalmazzon tétel adatokat.
Offset
number
egyedi értékek
Jelzi a lekérdezett tételek számához tartozó eltolást.
Abban az esetben, amikor egy kötegben a tételek száma (NumberOfItems
) meghaladja a lekérdezésben beállított limitet (Limit
), használja az eltolást a limitet meghaladó további tételek lekérdezéséhez.
Kimutatás lekérdezése Settlement
használatával:
A Settlement
kérés eredményét JSON formában válaszoljuk meg. A válasz a következő paramétereket tartalmazza:
Data
JSON string
egyedi érték
ResultCode
string
SUCCESSFUL (a pénzügyi kimutatás lekérdezése sikeres volt)
Hiba esetén a következő eredménykódok jelölik a hiba okát:
FunctionNotImplemented
InactiveStore
MissingParameter
MissingRemoteAddress
UnauthorizedAccess
UnauthorizedRemoteAddress
UnknownProvider
UnknownProviderForStore
UnknownStore
WrongApikey
WrongParameter
Jelzi a pénzügyi lekérdezés eredményét.
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.
A fenti Settlement
kérésre adott válasz:
Sikeres lekérdezés esetén tartalmazza a at.