PSD2 API tájékoztató

Bankunk a hatályos jogszabályi előírásoknak megfelelően létrehozta azokat a szabványos interfészeket (ún. PSD2 API-kat), amelyek a 2366/2015-ös uniós irányelv (az ún. PSD2 Irányelv) előírásai szerint hozzáférést biztosítanak a PSD2 Irányelv szerinti pénzforgalmi szolgáltatók számára a PSD2 Irányelvben meghatározott fizetési szolgáltatásokhoz. Bankunk az előírásoknak megfelelően hozzáférést biztosít a PSD2 API-k dokumentációjához és  a PSD2 API-k teszt környezetéhez (ún. sandboxhoz) mindazon hozzáférést igénylő pénzforgalmi szolgáltatók számára, amelyek rendelkeznek a hozzáféréshez szükséges működési engedéllyel, vagy amelyek hitelt érdemlően bizonyítják, hogy a működési engedélyük kiadása folyamatban van. A PSD2 API dokumentációja kizárólag angol nyelven érhető el.

A PSD2 API-val kapcsolatos legfontosabb információk a következők:

  • A PSD2 API-kat a Berlin Group NextGenPSD2 Framework-je alapján hoztuk létre.
  • A PSD2 API ún.  REST-API hívásokat fogad.
  • Az API HTTP üzenetek törzsének formátuma JSON.
  • A megoldásban bankunk kizárólag az ún. átirányításos (redirect) erős ügyfél-hitelesítést teszi elérhetővé.
  • Az API az autorizáció egyértelmű elindítását igényli (explicit authorisation).

A PSD2 API-n keresztül elérhető szolgáltatások köre a következő:

  • Fizetés kezdeményezés szolgáltatás (Payment Initiation Service - PIS):
    • Fizetési megbízás kezdeményezése
    • Fizetési megbízás státusz adatainak lekérdezése
       
  • Aláíró kosár (Signing Baskets Services - SBS)
    • Az aláíró kosár több azonos típusú fizetési megbízás kezdeményezés egy lépésben történő hitelesítésére szolgál
       
  • Számlainformációs lekérdezés szolgáltatás (Account Information Service - AIS):
    • Egyenleg információ az előre megadott engedélyben (consent) szereplő számlá(k)ról
    • Részletes számla adatok az előre megadott engedélyben (consent) szereplő számlá(k)ról
    • Tranzakciós adatok az előre megadott engedélyben (consent) szereplő számlá(k)ról
       
  • Fedezetvizsgálat hozzáférés szolgáltatás (Confirmation of Funds Service - PIIS)

 

A PSD2 API végpontjai és metódusai a következők:

  • Payment Initiation Service (PIS):
    • POST/v1/{payment-service}/{payment-product} ---  Payment initiation request
    • GET/v1/{payment-service}/{payment-product}/{paymentId}  --- Get Payment Information
    • DELETE/v1/{payment-service}/{payment-product}/{paymentId}  --- Payment Cancellation Request
    • GET/v1/{payment-service}/{payment-product}/{paymentId}/status   --- Payment initiation status request
    • POST/v1/{payment-service}/{payment-product}/{paymentId}/authorisations   --- Start the authorisation process for a payment initiation
    • GET/v1/{payment-service}/{payment-product}/{paymentId}/authorisations   --- Get Payment Initiation Authorisation Sub-Resources Request
    • GET/v1/{payment-service}/{payment-product}/{paymentId}/authorisations/{authorisationId}  --- Read the SCA Status of the payment authorisation
    • POST/v1/{payment-service}/{payment-product}/{paymentId}/cancellation-authorisations   --- Start the authorisation process for the cancellation of the addressed payment
    • GET/v1/{payment-service}/{payment-product}/{paymentId}/cancellation-authorisations   --- Will deliver an array of resource identifications to all generated cancellation authorisation sub-resources.
    • GET/v1/{payment-service}/{payment-product}/{paymentId}/cancellation-authorisations/{cancellationId}  --- Read the SCA status of the payment cancellation's authorisation.
       
  • Signing Baskets Services (SBS)
    • POST/v1/signing-baskets   --- Create a signing basket resource
    • GET/v1/signing-baskets/{basketId}   --- Returns the content of a signing basket object.
    • DELETE/v1/signing-baskets/{basketId}   --- Delete the signing basket
    • GET/v1/signing-baskets/{basketId}/status   --- Read the status of the signing basket
    • POST/v1/signing-baskets/{basketId}/authorisations   --- Start the authorisation process for a signing basket
    • GET/v1/signing-baskets/{basketId}/authorisations   --- Get Signing Basket Authorisation Sub-Resources Request
    • GET/v1/signing-baskets/{basketId}/authorisations/{authorisationId}   --- Read the SCA status of the signing basket authorisation
       
  • Account Information Service (AIS):
    • GET/v1/accounts   --- Read Account List
    • GET/v1/accounts/{account-id}   --- Read Account Details
    • GET/v1/accounts/{account-id}/balances   --- Read Balance
    • GET/v1/accounts/{account-id}/transactions   --- Read transaction list of an account
    • GET/v1/accounts/{account-id}/transactions/{resourceId}   --- Read Transaction Details
    • POST/v1/consents   --- Create consent
    • GET/v1/consents/{consentId}   --- Get Consent Request
    • DELETE/v1/consents/{consentId}   --- Delete Consent
    • GET/v1/consents/{consentId}/status   --- Consent status request
    • POST/v1/consents/{consentId}/authorisations   --- Start the authorisation process for a consent
    • GET/v1/consents/{consentId}/authorisations   --- Get Consent Authorisation Sub-Resources Request
    • GET/v1/consents/{consentId}/authorisations/{authorisationId}   --- Read the SCA status of the consent authorisation.
       
  • Confirmation of Funds Service (PIIS) returns a confirmation of funds request.
    • POST/v1/funds-confirmations   --- Confirmation of Funds Request

Amennyiben Ön engedélyezett pénzforgalmi szolgáltató, vagy hitelt érdemlően tudja bizonyítania, hogy engedélyezési eljárása folyamatban van, akkor kérjük írjon a psd2api@mbhdunabank.hu  e-mail címre, és kollégáink hozzáférést adnak Ön számára a PSD2 dokumentációhoz és teszt környezetekhez.