Kosár
  • Nincs találat

CIB PSD2 API

Ü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.4-es 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 Service 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ó

PIISP (Payment Instrument Issuing Service Provider):

Pénzhelyettesítő fizetési eszközt kibocsá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. A Berlin Group útmutató 1.3-as verziójától való eltérések

CIB Bank által implementált szolgáltatások részletes, mező szintű dokumentációját az interfész definíciós (yaml) file tartalmazza.

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.

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

  • POST consents/{consentId}/authorisations
  • PUT consents/{consentId}/authorisations/{authorisationId}
  • GET card-accounts
  • GET card-accounts/{account-id}
  • GET card-accounts/{account-id}/balances
  • GET card-accounts/{account-id}/transactions
  • POST signing-baskets
  • POST signing-baskets/{basketId}/authorisations
  • PUT signing-baskets/{basketId}/authorisations/{authorisationId}
  • GET signing-baskets/{basketId}/authorisations/{authorisationId}
  • POST bulk-payments/{payment-product}
  • GET bulk-payments/{payment-product}/{paymentId}
  • GET bulk-payments/{payment-product}/{paymentId}/status
  • POST {payment-service}/{payment-product}/{paymentId}/authorisations
  • PUT {payment-service}/{payment-product}/{paymentId}/authorisations/{authorisationId}
  • DELETE {payment-service}/{payment-product}/{paymentId}
  • POST {payment-service}/{payment-product}/{paymentId}/cancellation-authorisations
  • GET {payment-service}{payment-product}/{paymentId}/cancellation-authorisations
  • PUT {payment-service}/{payment-product}/{paymentId}/cancellation-authorisations/{cancellationId}
  • GET {payment-service}/{payment-product}/{paymentId}/cancelation-authorisations/{cancellationId}

OAuth folyamat

  • Ügyfél autorizációhoz csak az OAuth2 protokoll (módszer) használható
  • OAuth szerver automatikusan regisztrálja a TPP-ket, amikor az első consent-et vagy payment-et beküldik, amennyiben a TPP rendelkezik megfelelő érvényes tanúsítvánnyal.
  • Sikertelen OAuth autorizáció eredményeként a kérő fél nem kaphat hozzáférést az adott erőforráshoz. Ilyenkor az autorizá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.

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 accounts/{account-id}/transactions
  • GET card-accounts/{account-id}/transactions

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

  • pending: várakozó 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

nem támogatott

hungarian-credit-transfers 

támogatott

nem támogatott

támogatott

sepa-credit-transfers

támogatott

nem támogatott

nem támogatott

 

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

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

 

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

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

Milyen címen érhető el az éles CIB PSD2 API?

https://api.cib.hu

 

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ó. 

 

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.
PSD2 API technikai leírás

PSD2 API technikai leírás

Kapcsolódó dokumentum

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

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)