Comment on page

Extra paraméterek

A RaiffeisenPay - egyedi módon - kétszereplős fizetési kérelem létrehozását is lehetővé teszi a kereskedő számára, a vásárló részvétele nélkül. (Emellett elérhető a hagyományos, háromszereplős fizetési kérelem létrehozása is - ahol a vásárló megadja a fizetési kérelem létrehozásához szükséges adatokat a megfelelő felületen.)
A fent leírt, kétszereplős fizetési kérelemhez (amiben nem vesz részt a vásárló) a következőknek kell teljesülnie:
PaymentMethod paraméter kizárólag az RTP értéket tartalmazza
átadásra kerül a PayerIdentificationType
átadásra kerül a PayerIdentificationValue
Ebben az esetben a fizetési felület nem töltődik be, helyette a vásárló a Start hívás során visszairányításra kerül a korábban megadott ResponseUrl címre. A fizetési kérelem a háttérben kerül beküldésre a fizetési szolgáltató számára, a kérelem eredményét pedig aszinkron módon válaszoljuk meg a kereskedő számára.
Paraméterek
A RaiffeisenPay a következő szolgáltató specifikus Extra paraméterekkel rendelkezik:
Paraméter
Típus
Érték
Leírás
PaymentMethod
array
QR
RTP (Fizetési kérelem)
Választható fizetési módok.
PayerNote
string
​
(QR esetén maximum 44 karakter, RTP esetén maximum 140 karakter)
egyedi értékek
Fizetési közlemény.
PayerIdentificationType
string
email
bban
iban
phone
txid (adóazonosító jel)
txnb (adószám)
Vásárló azonosítására használt adat típusa.
​
Megkötések:
• email: szabványos email formátum
• iban: IBAN formátumban megadott magyar bankszámlaszám
• bban: Magyarországon használt formátumban megadott magyar bankszámlaszám 
• phone: “+36-xxxxxxx” formátumban megadott telefonszám
• txid: 10 karakter, csak számok
• txnb: Céges adószám, “HUxxxxxxxx” (kizárólag EU közösségi adószám formátum)
PayerIdentificationValue
string
​
(maximum 64 karakter)
egyedi érték
Bankszámlaszám, vagy az ahhoz rögzített, másodlagos vásárlói azonosító értéke.

Megkötések:
• email: szabványos email formátum
• iban: IBAN formátumban megadott magyar bankszámlaszám
• bban: Magyarországon használt formátumban megadott magyar bankszámlaszám 
• phone: “+36-xxxxxxx” formátumban megadott telefonszám
• txid: 10 karakter, csak számok
• txnb: Céges adószám, “HUxxxxxxxx” (kizárólag EU közösségi adószám formátum)
InvoiceId
string
egyedi érték
Vásárlás számlájának sorszáma.
LoyaltyId
string
egyedi érték
Vásárlás során felhasznált hűségkártya azonosítója.
NavCheckId
string
egyedi érték
Vásárláshoz tartozó NAV ellenőrző kód.
PaymentDueDate
string

(19 karakter)
Dátum a következő formátumban:

ÉÉÉÉ-HH-NN ÓÓ:PP:MM
Fizetési határidő, mely kizárólag RTP (fizetési kérelem) esetén használható. 

Ez a fizetési határidő:
• a tranzakció létrehozásánál későbbi,
•  a tranzakció érvényességénél viszont korábbi időpont.

Figyelem! Ez a határidő csak a fizető fél tájékoztatására szolgál, így értéke nem azonos a tranzakció érvényességi idejével.
TransactionExpirationTimeFormat
string
Minutes
Date
Formátum, melyben a tranzakció érvényességi ideje megadásra kerül.
TransactionExpirationTimeValue
integer
string
(19 karakter)
Egész szám vagy dátum, a következő formátumban:

ÉÉÉÉ-HH-NN ÓÓ:PP:MM
A tranzakció érvényességi ideje, mely a felsorolt formátumok egyikében adható meg. A kiválasztott formátum típusát jelezze a következő paraméterben:  TransactionExpirationTimeFormat.

Választható formátumok:

• időtartam (Minutes): használatával  megadhatja a tranzakció érvényességét az inicializálástól (Init) számítva, percben kifejezve.

• időpont (Date): használatával megadhatja az adott tranzakció érvényességét a következő formátumban: ÉÉÉÉ-HH-NN ÓÓ:PP:MM

Bármely formátum esetében a tranzakció érvényességi ideje maximum 60 nap. Az érvényességi idő lejárata után a még függőben lévő tranzakciók TIMEOUT státusszal zárulnak le.

Amennyiben az érvényességi idő nem kerül átadásra, rendszerünk az alapértelmezett értéket veszi figyelembe. Az alapértelmezett érvényességi idő kereskedői boltonként egyedileg is módosítható, ehhez vegye fel a kapcsolatot ügyfélszolgálatunkkal a következő címen:

[email protected]​
Mintakód
{
	"PaymentMethod": ["RTP"],
	"PayerIdentificationType": "iban",
	"PayerIdentificationValue": "HU54120670080165389100200003",
	"PayerNote": "Transfer note",
	"InvoiceId": "PM2554/2022",
	"LoyaltyId": "LI9798",
	"NavCheckId": "43BC6",
	"TransactionExpirationTimeFormat": "Minutes",
	"TransactionExpirationTimeValue": 30
}

Paraméter	Típus	Érték	Leírás
`PaymentMethod`	array	QR RTP (Fizetési kérelem)	Választható fizetési módok.
`PayerNote`	string (QR esetén maximum 44 karakter, RTP esetén maximum 140 karakter)	egyedi értékek	Fizetési közlemény.
`PayerIdentificationType`	string	email bban iban phone txid (adóazonosító jel) txnb (adószám)	Vásárló azonosítására használt adat típusa. Megkötések: • email: szabványos email formátum • iban: IBAN formátumban megadott magyar bankszámlaszám • bban: Magyarországon használt formátumban megadott magyar bankszámlaszám • phone: “+36-xxxxxxx” formátumban megadott telefonszám • txid: 10 karakter, csak számok • txnb: Céges adószám, “HUxxxxxxxx” (kizárólag EU közösségi adószám formátum)
`PayerIdentificationValue`	string (maximum 64 karakter)	egyedi érték	Bankszámlaszám, vagy az ahhoz rögzített, másodlagos vásárlói azonosító értéke. Megkötések: • email: szabványos email formátum • iban: IBAN formátumban megadott magyar bankszámlaszám • bban: Magyarországon használt formátumban megadott magyar bankszámlaszám • phone: “+36-xxxxxxx” formátumban megadott telefonszám • txid: 10 karakter, csak számok • txnb: Céges adószám, “HUxxxxxxxx” (kizárólag EU közösségi adószám formátum)
`InvoiceId`	string	egyedi érték	Vásárlás számlájának sorszáma.
`LoyaltyId`	string	egyedi érték	Vásárlás során felhasznált hűségkártya azonosítója.
`NavCheckId`	string	egyedi érték	Vásárláshoz tartozó NAV ellenőrző kód.
`PaymentDueDate`	string (19 karakter)	Dátum a következő formátumban: ÉÉÉÉ-HH-NN ÓÓ:PP:MM	Fizetési határidő, mely kizárólag RTP (fizetési kérelem) esetén használható. Ez a fizetési határidő: • a tranzakció létrehozásánál későbbi, • a tranzakció érvényességénél viszont korábbi időpont. Figyelem! Ez a határidő csak a fizető fél tájékoztatására szolgál, így értéke nem azonos a tranzakció érvényességi idejével.
`TransactionExpirationTimeFormat`	string	Minutes Date	Formátum, melyben a tranzakció érvényességi ideje megadásra kerül.
`TransactionExpirationTimeValue`	integer string (19 karakter)	Egész szám vagy dátum, a következő formátumban: ÉÉÉÉ-HH-NN ÓÓ:PP:MM	A tranzakció érvényességi ideje, mely a felsorolt formátumok egyikében adható meg. A kiválasztott formátum típusát jelezze a következő paraméterben: `TransactionExpirationTimeFormat`. Választható formátumok: • időtartam (Minutes): használatával megadhatja a tranzakció érvényességét az inicializálástól (Init) számítva, percben kifejezve. • időpont (Date): használatával megadhatja az adott tranzakció érvényességét a következő formátumban: ÉÉÉÉ-HH-NN ÓÓ:PP:MM Bármely formátum esetében a tranzakció érvényességi ideje maximum 60 nap. Az érvényességi idő lejárata után a még függőben lévő tranzakciók TIMEOUT státusszal zárulnak le. Amennyiben az érvényességi idő nem kerül átadásra, rendszerünk az alapértelmezett értéket veszi figyelembe. Az alapértelmezett érvényességi idő kereskedői boltonként egyedileg is módosítható, ehhez vegye fel a kapcsolatot ügyfélszolgálatunkkal a következő címen: [email protected]

RaiffeisenPay

SimplePay

Last modified 2mo ago