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

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:

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:

Mintakód

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

PreviousRaiffeisenPay NextSimplePay

Last updated 7 months ago