Consent kezelés (Éles)
Ez az éles környezet Consent setupja. A jóváhagyott Consent-tel valós tranzakciók indíthatók!
Ez a lépés CSAK a Payment API és Balance API használatához szükséges.
EAM, Fizetési kérelem és Online Fizető Oldal esetén nincs Consent management folyamat.
Mi az a Consent?
A Consent (hozzájárulási kérelem) egy engedélyezési mechanizmus. A Consent létrehozása API-n keresztül vagy a Raiffeisen Pay Portálon is történhet, de a jóváhagyását csak a Raiffeisen Pay Portálon, manuálisan lehet elvégezni.
Consent állapotok:
IN_PROGRESS- Consent létrehozva, de még nincs elfogadva/elutasítvaAPPROVED- ElfogadvaDECLINED- ElutasítvaREVOKED- Visszavonva
Consent létrehozása API-n keresztül
Létrehozás folyamata
A Consent létrehozása történhet API híváson keresztül. A létrehozott Consentek IN_PROGRESS státuszúak, payment beküldésre még nem alkalmasak. A Jóváhagyó személynek még engedélyezni kell a felhasználhatóságát.
API hívás részletei
Endpoint:
POST https://premium-api.raiffeisen.hu/v1/consent/create
Az éles környezet új URL-je: https://premium-api.raiffeisen.hu
Mit kell megadni a Consent létrehozáskor?
- **Jóváhagyó személy DirektNet azonosítója ** (
signer) - nem kötelező - Lejárat időpontja (
expiryDate) - Valós számlaszámok, amihez a Jóváhagyó személy aláírói felhatalmazással rendelkezik (
accountList)
Az éles környezetben valós bankszámlákat kell megadni! Minden tranzakció ezeken a számlákon fog megjelenni.
Válasz: Ha a bank befogadta a Consentet, visszaküldi a Consent ID-t válaszként. Ezt az ID-t kell használni a jóváhagyási folyamatban és a paymentek indításakor és az információk lekérdezésekor.
Tárold biztonságosan a Consent ID-t (database, secrets manager). Minden Payment API és Balance API híváshoz szükséged lesz rá.
Consent létrehozása RPP Portalra bejelentkezve
Létrehozás folyamata
A Consent létrehozása az RPP Portalon keresztül is történhet, mindkét (Jóváhagyó vagy Rendszeradminisztrátor) szerepkörrel. A létrehozott Consentek IN_PROGRESS státuszúak, payment beküldésre még nem alkalmasak. A Jóváhagyó személynek még engedélyezni kell a felhasználhatóságát.
Lépések az RPP portálon
1.a Jóváhagyó jogosultsággal rendelkező felhasználó esetén
A "Hozzájáruások" menüpont alatt található "Új hozzájárulás" gombra kattintva
1.b Rendszeradminisztrátor jogosultsággal rendelkező felhasználó esetén
Közvetlenül a "Hozzájárulás létrehozása" menüpont alatt
2. Kezelt számla/számlák kiválasztása és lejárati dátum megadása
A Consent létrehozása során meg kell adni az egy vagy több számlaszámot és a Consent érvényességének lejárati dátumát.
A "Létrehozás" gombra kattintva a Consent létrejön IN_PROGRESS státusszal. A létrehozást nem szükséges aláírni, mivel a létrejött Consent ebben státuszban még nem használható, felhasználás előtt azt jóvá kell hagyni.
A létrehozott Consentet Jóváhagyói jogosultsággal rendelkezőfelhasználó tudja jóváhagyni.
Consent jóváhagyás (RPP Portal)
Jóváhagyás folyamata
A Consent sikeres létrehozása után a Consentben megjelölt felhasználónak az éles Raiffeisen Pay Portál felületén el kell azt fogadni ahhoz, hogy az adott Consent felhasználható legyen paymentek indításához.
Éles RPP portál: https://payportal.raiffeisen.hu
Az elfogadás után az így jóváhagyott (APPROVED státuszú) Consentekre hivatkozással beküldhető a payment és lekérhető az információ a Payment API-n.
A consentek lejáratukig vagy visszavonásukig érvényesek.
Egy felületen elutasított vagy visszavont Consentet nem lehet ismét aktiválni. Ilyenkor új Consent létrehozására van szükség.
Lépések az RPP portálon
1. Beérkező kérelmek megtekintése
A felhasználó azonosítójához indított új Consentek, valamint az előzetesen jóváhagyó (signer) nélkül létrehozott Consentek, amelyekben szereplő számlákhoz a felhasználónak megfelelő jogosultsága van, a "Beérkező kérelmek" menüpont alatt találhatók.
A Consenteken a számlaszámok listája is ellenőrizhető (egy Consentben több számlaszám is lehet).
Ellenőrizzd hogy a helyes bankszámlákat tartalmazza a Consent! Ez kritikus, mert a tranzakciók ezeken a számlákon fognak megjelenni.
2. Consent elfogadása
Ha a hozzájárulási kérelmet rendben van, a "Kérelem elfogadása" gombra kattintva elfogadható.
A kérelem elfogadása gombra kattintással hozzájárul, hogy a Kérelmező a jelen felhatalmazásban adott hozzájárulását a Raiffeisen Pay csatornán küldött tranzakcióihoz csatolja.
3. Aláírás
Password és SMS kód megadásával hitelesíteni kell a folyamatot.
Éles környezetben valódi SMS-t kapsz a regisztrált telefonszámra. Az SMS 30-60 másodpercen belül megérkezik. Részletek →
Ezután már a "Hozzájárulások" között jelenik meg a Consent.
Consent kezelése
Inaktiválás
Az "Inaktiválás" gombbal lehet megszüntetni a Consent felhasználhatóságát.
Inaktivált vagy lejárt Consentet nem lehet újra aktiválni, újat kell készíteni.
Lejárat meghosszabbítása
Az "Hosszabbítás" gombbal lehet a Consent felhasználhatóságának lejáratát meghosszabbítani. Hosszabbítás csak akkor lehetséges, ha a Consent még érvényes, lejárati ideje korábbi a maximálisan megadható 3 hónapos határnál, és az eredeti jóváhagyó a bejelentkezett felhasználó.
Tranzakciók megtekintése
A Consent felhasználásával küldött tranzakciókat a "Tranzakciók" menüpont alatt lehet megtekinteni.
Kiválasztható a Consent ID és az időszak, amin belül látni szeretnénk a végrehajtott tranzakciókat.
Következő lépés
Most, hogy a Consent jóváhagyva indíthatod az első éles API hívást.