RaiffeisenPay specifikus 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éterTípusÉrtékLeí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 (maximum 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 (maximum 19 karakter)

Egész szám vagy dátum, a következő formátumban: ÉÉÉÉ-HH-NN ÓÓ:PP:MM

Mintakód

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

Last updated