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: [e-mail]

Mintakód

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