Kosár
  • Nincs találat

CIB PSD2 API Sandbox

Üdvözöljük a banki szolgáltatások új világában!
Milyen szolgáltatást nyújt a CIB PSD2 API?

Milyen szolgáltatást nyújt a CIB PSD2 API?

 

A CIB PSD2 API szolgáltatás lehetőséget nyújt vállalkozásának, hogy bankunk pénzforgalmi számlával rendelkező ügyfelei részére számlainformációs és fizetéskezdeményezési szolgáltatást nyújtson. 

A PSD2 API integráció kialakítása során bankunk a Berlin Group 1.3 verziójú útmutatóját követi. Kérjük, tekintse át a CIB PSD2 API dokumentációját, majd a Sandbox segítségével tesztelje fejlesztését. 

A jogszabályban előírt feltételek teljesítése és a szükséges tanúsítványok birtokában 2019. szeptember 14-től használhatja szolgáltatásunkat. 

 

Berlin Group 1.3 útmutatótól való eltérések

Berlin Group 1.3 útmutatótól való eltérések

 

1. Általános információk

 

A dokumentáció célja interfészek integrációs tesztelésének támogatása az alábbi esetekben:

  • A CIB Bank számlavezetett ügyfelei részére számlainformációs és fizetéskezdeményezési szolgáltatást nyújtó szolgáltatók számára.
  • A kártyaalapú készpénzhelyettesítő fizetési eszközt kibocsátó pénzforgalmi szolgáltatók visszaigazoláskérő tevékenységéhez. 

A CIB Bank a Berlin Group által javasolt útmutató 1.3-as verzióját alkalmazta az interfész kialakítása során, ezért javasoljuk a tesztelés megkezdése előtt ennek tanulmányozását. 

Az alábbiakban bemutatjuk a Berlin Group útmutatójától való eltéréseket. 

 

2. Rövidítések, fogalmak

 

Rövidítés

Leírás

TPP (Third Party Payment Provider):

Számlainformációs szolgáltatást vagy fizetéskezdeményezési szolgáltatást nyújtó, bankon kívüli (ún. harmadik fél) szolgáltató

AISP (Account Information Service Provider):

Számlainformációs szolgáltatást nyújtó szolgáltató

PISP (Payment Initiation Service Provider):

Fizetéskezdeményezési szolgáltatást nyújtó szolgáltató

PSU (Payment Service User):

Pénzforgalmi szolgáltatást igénybe vevő felhasználó

SCA (Strong Customer Authentication):

Erős ügyfélhitelesítés

 

 

3. Consent és payment beküldésekor a PSU-ID vagy PSU-Corporate-ID fejlécnek (de csakis az egyiknek) ki kell lennie töltve ahhoz, hogy a retail/corporate routing megtörténhessen. Bármilyen értékkel ki lehet tölteni, a konkrét érték nem számít.

 

4. A Berlin Group útmutató 1.3-as verziójától való eltérések

 

Bankunk nem támogatja a fizetési megbízások visszavonására (törlésére) vonatkozó kérést:

  • DELETE {payment-service}/{payment-product}/{paymentId} 

A TPP-ken keresztül benyújtott fizetéskezdeményezések visszavonására (törlésére) csak egyéb, bankunk által biztosított elektronikus csatornán van lehetősége a PSU-nak.


A következő interfészben a bookingStatus paraméterben "both" érték használata nem támogatott:

  • GET /v1/accounts/{account-id}/transactions
  • GET /v1/card-accounts/{account-id}/transactions

Egyszerre csak egy bookingStatus szerinti tranzakció kérhető le. Használható bookingStatus paraméterek:

  • pending: várakozó tételek lekérdezése
  • notFulfilled: nem teljesült tételek lekérdezése
  • booked: teljesült tételek

 

Bankunk fizetéskezdeményezési kérések esetében eltérő fizetési megbízástípusokat (payment product) támogat, amelyek a következők: 

  • fx-credit-transfers – eseti devizautalás, nem SEPA (bankon belül, kívül)
  • hungarian-credit-transfers – eseti és rendszeres forintutalás (bankon belül, kívül)
  • sepa-credit-transfers – euroban indított devizautalás (bankon belül, kívül)

A következő kombinációkban értelmezhetőek a fizetési megbízástípusok (payment product) és szolgáltatások: 

payment product payments bulk-payments periodic-payments
fx-credit-transfers támogatott nem támogatott támogatott
Hungarian-credit-transfers  támogatott nem támogatott nem támogatott
SEPA-credit-transfers támogatott nem támogatott nem támogatott

 

5. A CIB PSD2 API Sandbox működésére vonatkozó tudnivalók

Az interfészek tesztelését a bank egy Sandbox alkalmazás segítségével támogatja, amelynek jellemzői:

  • fix rendszerdátumot használ: 2019-02-10 (validációk is ezt ellenőrzik)
  • fix kérésekre fix válaszokat adnak az interfészek, ehhez a csatolt sandbox_teszt.txt nyújt támogatást
  • számlaegyenlegek nem változnak
  • payment-service-ek közül a periodic-payments-et és a bulk payments-et nem támogatja a bank

 

A következő kéréseket nem támogatja a CIB PSD2 API Sandbox:

  • GET card-accounts 
  • GET card-accounts/{account-id} 
  • GET card-accounts/{account-id}/balances 
  • GET card-accounts/{account-id}/transactions 
  • POST bulk-payments/{payment-product} 
  • GET bulk-payments/{payment-product}/{paymentId} 
  • GET bulk-payments/{payment-product}/{paymentId}/status 
  • POST periodic-payments/{payment-product} 
  • GET periodic-payments/{payment-product}/{paymentId} 
  • GET periodic-payments/{payment-product}/{paymentId}/status 
  • DELETE consents/{consentId} 

OAuth folyamat

  • Ügyfél authorizációhoz az OAuth2 protokoll használható 
  • Az OAuth szerver automatikusan regisztálja aTPP-t, amikor az első consent-et vagy payment-et beküldi, amennyiben a TPP rendelkezik megfelelő érvényes tanúsítvánnyal.
  • Az OAuth authorizációhoz szükséges információk innen kérdezhetőek le: https://api-test.cib.hu:443/psd2/.well-known/oauth-authorization-server
  • Sikertelen OAuth authorizáció eredményeként a kérő fél nem kaphat hozzáférést az adott erőforráshoz. Ilyenkor az authorizációs kérésben átadott TPP callback url hívódik meg, hiba kóddal ('error' paraméter), hiba leírással ('error_description' paraméter) kiegészítve. A hiba kód értéke 'access_denied' lesz.

Authorizáció

A felhasználó azonosítására használt oldalon a következő teszt felhasználóval lehet belépni: 
felhasználó név: user1
Jelszó: 123
A consent-ek és payment-ek jóváhagyásához használt aláíró kód bármi lehet.

Tudnivalók a CIB PSD2 API Sandbox használatához

Tudnivalók a CIB PSD2 API Sandbox használatához

 

Mennyibe kerül a CIB PSD2 API Sandbox használata?

A CIB Bank a CIB PSD2 API Sandbox használatát díjmentesen biztosítja  az érdeklődők részére.

 

Milyen címen érhető el a CIB PSD2 API Sandbox?

https://api-test.cib.hu

 

Mikortól lehet élesben használni a rendszert?

A PSD2 direktíva előírásainak megfelelően a CIB PSD2 API Sandbox 2019. szeptember 14-től lesz használható éles üzemben.

 

Hogyan értesülünk az API változásokról?

A CIB PSD2 API Sandbox használatához szükséges technikai információkban történő változások dokumentációját a bank verziókövetéssel honlapján (www.cib.hu) teszi közzé.

 

A PSD2 API integráció során milyen nemzetközi szabványt követ a bank?

A PSD2 API integráció kialakítása során bankunk a Berlin Group (https://www.berlin-group.org/) útmutató 1.3 verzióját követi, eltérésekkel. Az eltérések összefoglalója a Kapcsolódó dokumentumok részben található. 

 

Hogyan működik a CIB PSD2 API Sandbox?

Alkalmazásával csatlakozzon a CIB Bank API Gateway-éhez a https://api-test.cib.hu címen. A CIB PSD2 API Sandbox interfészei a teszt során fix kérésekre fix válaszokat adnak. A teszt során a számlaegyenlegek nem változnak.

 

Mi az AISP, ASPSP, PISP, PSU, SCA, TPP rövidítések jelentése?

  • AISP (Account Information Service Provider): Számlainformációkat összesítő szolgáltató (TPP)
  • ASPS (Account Servicing Payment Service Provider): Számlavezető pénzforgalmi szolgáltató
  • PISP (Payment Initiation Service Provider): Megbízásos online átutalási szolgáltató (TPP)
  • PSU (Payment Service User): Pénzforgalmi szolgáltatást igénybe vevő felhasználó
  • SCA (Strong Customer Authentication): Erős ügyfél-hitelesítés
  • TPP (Third Party Payment Provider): PSD2 szolgáltatásokat nyújtó harmadik fél.
Segíthetünk?

Segíthetünk?

 

A CIB PSD2 API Sandbox-szal kapcsolatos kérdéseit kérjük írásban a psd2_support@cib.hu emailcímre juttassa el hozzánk és az Ön által megadott e-mail címre válaszolunk. Kérjük, ellenőrizze a megadott e-mail cím helyességét. Arra törekszünk, hogy a lehető leghamarabb válaszoljunk, köszönjük a türelmét.

Segíthetünk?

Hívja CIB24 telefonos ügyfélszolgálatunkat!

CIB24 menütérkép
(+36 1) 4 242 242
9. Kártyatiltás és aktiválás
Kártyatiltás
9 1
Kártyaaktiválás
9 2
1. Lakossági ügyintézés
Számlaügyintézés
1 1
Kártyaügyintézés
1 2
Megtakarítás és értékpapír ügyintézés, eBroker
1 3
Hitel ügyintézés
1 4
Internetbank ügyintézés
1 5
Lízing ügyintézés
1 6
Biztosítások ügyintézése
1 7
2. Vállalkozások ügyintézése
Számlaügyintézés
2 1
Kártyaügyintézés
2 2
Megtakarítás és értékpapír ügyintézés, eBroker
2 3
Hitelügyintézés
2 4
Internetbank ügyintézés
2 5
Lízing ügyintézés
2 6
Biztosítások ügyintézése
2 7
3. Angol nyelvű menü
Angol nyelvű menü
3
4. CIB termékkel nem rendelkező érdeklődők
Hitelek és lízing
4 1
Lakossági szolgáltatások
4 2
Vállalkozások szolgáltatásai
4 3
Kérjen visszahívást! Chat

A CIB honlap sütiket használ, ezek segítségével tudjuk biztosítani a legjobb böngészési élményt. Az összes süti elfogadására kattintva, Ön beleegyezik, hogy a sütiket eltároljuk az eszközén. A sütik segítségével megkönnyítjük az oldalon a navigációt, és azokat az oldalhasználat elemzésére és marketing célokra használjuk fel. (Süti szabályzat)