Fizetési hivatkozás létrehozása
Last updated
Was this helpful?
Last updated
Was this helpful?
Használja a PaymentLinkCreate funkciót egy új fizetési link létrehozásához.
!
PaymentLinkCreate
POST
method=PaymentLinkCreate
json={JSON encode-olt paraméterek}
Az API paraméterek felosztása a következő:
kötelező és opcionálisan kötelező paraméterek
opcionális paraméterek
StoreName
string
A Nevogate szerződésben kerül meghatározásra.
Rendszerünkben tárolt egyedi bolt azonosító.
ProviderName
string
Barion2
BBAruhitel (MBH Online Áruhitel)
Borgun (Teya SecurePay)
Borgun2 (Teya RPG)
CIB
GP (Global Payments)
KHB (K&H Bank)
KHBSZEP
MKBSZEP
OTP
OTPAruhitel (OTP Bank Áruhitel)
OTPSimple (SimplePay)
OTPSimpleWire
PayPal
PayPalRest
PayU2 (Classic)
PayURest
PSC (Paysafecard)
RaiffeisenPay
RawMBHSZEP
RawOTPSZEP
Saferpay (Worldline)
Stripe
UniCredit
VivaWallet
A fizetési hivatkozáshoz kiválasztott fizetési szolgáltató.
Amount
(opcionálisan kötelező)
number
szabadon választható
(Magyar forint (HUF) esetén értéke pozitív egész szám.)
Bruttó végösszeg amit a vásárló kifizet.
Ahhoz, hogy a fizetendő végösszeget a vásárló adhassa meg, figyeljen a következőkre:
• az Amount paraméter ne kerüljön átadásra,
• vagy átadása esetén az értéke legyen 0
Ilyen esetben a vásárló a MinimumAmount és MaximumAmount értékek közötti összeget írhat be.
Az Amount megadása kötelező, amennyiben a MinimumAmount értéke 0 vagy nincs beállítva!
MinimumAmount
(opcionálisan kötelező)
number
szabadon választható
(Magyar forint (HUF) esetén értéke pozitív egész szám.)
A minimum bruttó végösszeg amit a vásárló beállíthat, amennyiben a végső fizetendő összeget a vásárló állíthatja be.
A MinimumAmount megadása kötelező, amennyiben az Amount értéke 0 vagy nincs beállítva!
EmailNotificationOnlySuccess
boolean
true
false
Amennyiben értéke true, rendszerünk kizárólag a sikeres tranzakcióról küld értesítést.
(Ebben az esetben a sikertelen tranzakcióról és a fizetési hivatkozás státuszának változásairól nem küldünk értesítést.)
NotificationUrl
string
(255 karakter)
NotificationEmail
string
szabványos email formátum
(maximum 1 db)
A kereskedő értesítési email címe, melyre rendszerünk a következő értesítéseket küldi:
tranzakció sikeres végrehajtása a fizetési hivatkozással
változás a fizetési hivatkozás státuszában
MaximumAmount
number
szabadon választható
(Magyar forint (HUF) esetén értéke pozitív egész szám.)
A maximum bruttó összeghatár amit a vásárló beállíthat (amennyiben a végső fizetendő összeget a vásárló állíthatja be).
Ha nem kerül átadásra, a vásárló felső összeghatár nélkül állíthat be összeget.
A MaximumAmount kizárólag a MinimumAmount paraméterrel együtt használható.
Currency
string
(3 karakter)
HUF (alapért.)
EUR
USD
...
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.)
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.
Language
string (2 karakter)
HUF (alapért.)
EUR
USD
...
(ISO 639-1 alapján)
A fizetési felület nyelve.
AutoCommit
string
“true” (alapért.)
“fasle”
Jelzi, hogy a bank azonnal vagy később hajtja végre a tranzakciót.
ExpirationTime
string
dátum, a következő formátumban:
ÉÉÉÉ-HH-NN ÓÓ:PP:MM
Meghatározza a link lejárati idejét. Az érvényesség maximálisan megadható ideje is 1 év.
Amennyiben nincs megadva a lejárati idő, úgy automatikusan 1 évre kerül beállításra.
InfoForm
string
product
service
Meghatározza a fizetési hivatkozás érkező oldalán bekérésre kerülő vásárlói adatokat (ezek az erős ügyfél-hitelesítéshez (PSD2/SCA) szükségesek).
A bekért adatokról a táblázat végén olvashat további részleteket.
PrivacyPolicyUrl
string (255 karakter)
szabadon választható (URL cím)
A kereskedői adatvédelmi nyilatkozatra mutató hivatkozás. Megadása esetén a vásárlónak el kell fogadnia a nyilatkozatot a fizetés előtt (a fizetési hivatkozás kezdő oldalán).
RedirectUrl
string (255 karakter)
szabadon választható (URL cím)
A fizetést követően a vásárló egy PayLink végoldalra kerül visszairányításra. Ha a RedirectUrl meg van adva, akkor ezen a végoldalon megjelenik egy "Vissza a kereskedő oldalára" gomb, amivel a vásárló a megadott RedirectUrl címre juthat.
Extra
string
egyedi értékek
Egyéb, illetve szolgáltató specifikus adatok.
Info
string
egyedi értékek
ModuleName
string (32 karakter)
egyedi értékek
Az alkalmazott szervizcsomag, programnyelv, keretrendszer, modul, stb. megnevezése.
ModuleVersion
string (8 karakter)
egyedi értékek
Az alkalmazott szervizcsomag, programnyelv, keretrendszer, modul, stb. verziószáma.
Az InfoForm értékei meghatározzák, hogy a PayLink érkező oldalán milyen adatok kerülnek bekérésre, a következők szerint:
Általános vásárlói adatok
tartalmazza
tartalmazza
Számlázási adatok
tartalmazza
tartalmazza
Szállítási adatok
tartalmazza
nem tartalmazza
Fizetési hivatkozás létrehozása PaymentLinkCreate kérés használatával:
A PaymentLinkCreate kérést eredményét JSON formában válaszoljuk meg. A válasz a következő paramétereket tartalmazza:
PaymentLinkName
string
(35 karakter)
egyedi értékek
A fizetési hivatkozás egyedi azonosítója a Nevogate rendszerében.
PaymentLinkUrl
string
URL cím
A fizetési hivatkozás URL címe.
PaymentLinkQR
string
URL cím
A fizetési hivatkozáshoz tartozó QR-kód URL címe.
Figyeljen arra, hogy a QR-kód funkció be legyen kapcsolva a PayAdminban, ellenkező esetben a visszatérési érték NULL lesz.
A QR-kód funkció bekapcsolását külön kell kérelmezni ügyfélszolgálatunkon.
ResultCode
string
SUCCESSFUL
Hiba esetén a következő eredménykódok jelölik a hiba okát:
InactiveStore
InactiveProvider
MissingParameter
MissingRemoteAddress
UnauthorizedAccess
UnauthorizedRemoteAddress
UnknownProvider
UnknownProviderForStore
UnknownStore
UnknownTransaction
WrongApikey
WrongParameter
WrongProviderSettings
A fizetési hivatkozás létrehozásának eredménye.
ResultMessage
string
leírás
Az egyes ResultCode értékek szöveges magyarázata.
Amount
number
az API kérésben megadott érték
Bruttó végösszeg amit a vásárló kifizet.
Currency
string
(3 karakter)
az API kérésben megadott érték
A fizetés devizaneme.
MultipleTransactions
boolean
false
Jelzi, hogy a fizetési link csak egyszer felhasználható fel sikeres fizetésre.
Language
string
(2 karakter)
HU (alapért.)
EN
DE
…
(Az API kérésben megadott érték.)
A fizetési felület nyelve.
OrderId
string
egyedi értékek (kivéve e-mail címek, illetve személyes adatok)
(Az API kérésben megadott érték.)
A megrendelés azonosítója a kereskedő áruházában.
UserId
string
egyedi értékek (kivéve e-mail címek, illetve személyes adatok)
(Az API kérésben megadott érték.)
A vásárló azonosítója a kereskedő áruházában.
AutoCommit
string
“true”
“fasle”
(Az API kérésben megadott érték.)
Jelzi, hogy a bank azonnal vagy később hajtja végre a tranzakciót.
ExpirationTime
string
dátum, a következő formátumban:
ÉÉÉÉ-HH-NN ÓÓ:PP:MM
(Az API kérésben megadott érték.)
Meghatározza a link lejárati idejét.
NotificationUrl
string
(255 karakter)
szabadon választható
(Az API kérésben megadott érték.)
NotificationEmail
string
szabványos email formátum
(Az API kérésben megadott érték.)
A kereskedő értesítési email címe, melyre rendszerünk a következő értesítéseket küldi:
tranzakció sikeres végrehajtása a fizetési hivatkozással
változás a fizetési hivatkozás státuszában
EmailNotificationOnlySuccess
boolean
true
false
(Az API kérésben megadott érték.)
Amennyiben értéke true, rendszerünk kizárólag a sikeres tranzakcióról küld értesítést.
(Ebben az esetben a sikertelen tranzakcióról és a fizetési hivatkozás státuszának változásairól nem küldünk értesítést.)
Extra
string
egyedi értékek
(Az API kérésben megadott érték.)
Egyéb illetve szolgáltató specifikus adatok.
Status
string
PENDING
SUCCESSFUL
ERROR
CANCELED
TIMEOUT
A fizetési hivatkozás státusza.
Created
string
dátum, a következő formátumban:
ÉÉÉÉ-HH-NN ÓÓ:PP:MM
A fizetési hivatkozás létrehozásának ideje.
LastModified
string
dátum, a következő formátumban:
ÉÉÉÉ-HH-NN ÓÓ:PP:MM
A fizetési hivatkozás utolsó módosításának ideje.
ResponseId
integer
egyedi értékek
A válaszüzenet egyedi azonosítója a Nevogate rendszerében.
Fizetési hivatkozás sikeres létrehozására adott válasz:
Rendszerünk ezen a címen értesíti a kereskedőt a fizetési hivatkozással létrehozott 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 ().
Rendszerünk ezen a címen értesíti a kereskedőt a fizetési hivatkozással létrehozott tranzakció státuszának változásáról ().