Extra paraméterek

A RaiffeisenPay - egyedi módon - kétszereplős fizetés 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és létrehozása is - ahol a vásárló megadja a fizetési kérelem létrehozásához szükséges adatokat vagy beolvashatja az EAM deeplinket a megfelelő felületen.)

A fent leírt, kétszereplős fizetéshez (amiben nem vesz részt a vásárló) a következőknek kell teljesülnie:

• GatewayPaymentPage paraméter false értékű

• PaymentMethod paraméter kizárólag egy értéket (RTP vagy EAM) tartalmazzon

  • RTP esetében:

    • átadásra kerül a PayerIdentificationType

    • átadásra kerül a PayerIdentificationValue

  • EAM esetében:

    • nincs szükség plusz paraméterre

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 tranzakció eredményét pedig aszinkron módon válaszoljuk meg a kereskedő számára.

EAM esetében a létrejött deeplinkhez a kereskedő egy Details API kérés során juthat hozzá, aminek értéke a ProviderSpecificData objektum deeplink paraméterében található.

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	EAM RTP (Fizetési kérelem)	Választható fizetési módok.
PayerNote	string (EAM esetén maximum 70 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)
InvoiceReference	string	egyedi érték	Vásárlás számlájának sorszáma.
EamPurposeCode	string	IPEW (alapért.) CDCD COMT ELEC GASB GOVT GSCB INSU IPAT IPEW IPPS IPU2 IVPT MP2B MP2P OTLC PHON UBIL WTER	Valós fizetési helyzet a ISO 20022 kódtáblából.
EamDeviceType	string	Browser (alapért.) CashRegister SmartDevice MessagingApp	EAM fizetési eszköz típusa.
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 RTP esetében maximum 60 nap, EAM esetében maximum 180 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", "EAM"],
	"PayerIdentificationType": "iban",
	"PayerIdentificationValue": "HU54120670080165389100200003",
	"PayerNote": "Transfer note",
	"InvoiceReference": "PM2554/2022",
	"EamPurposeCode": "IPEW",
	"EamDeviceType": "Browser",
	"TransactionExpirationTimeFormat": "Minutes",
	"TransactionExpirationTimeValue": 30
}