Preskoči na glavno vsebino
BKS / Podpora / Digitalno poslovanje

Odprto bančništvo (TPP) – XS2A vmesnik (PSD2)

Naši vmesniki »finAPI XS2A API« sledijo standardom Berlin Group. Od 14. 3. 2019 je testno okolje, v nadaljevanju poimenovano sandbox, brez omejitev na voljo vsem ponudnikom storitev odreditve plačil, ponudnikom storitev informacij o računih ter ponudnikom plačilnih storitev, ki izdajajo kartično vezane plačilne instrumente. Preverjanje razpoložljivosti sredstev pri PISP je v naši arhitekturi izvedeno avtomatizirano znotraj transakcije. Če na računu ni zadostnega kritja, se klicatelju vrne ustrezna napaka. Zato ločena vključitev posebne storitve Funds Check ni potrebna.

XS2A PSD2 vmesnik

Testni vmesnik – XS2A Sandbox Testni vmesnik (XS2A Sandbox) vsebuje izključno testne podatke, ki jih zagotavlja finAPI. Vse podrobnosti o vmesniku so na voljo v razvijalski dokumentaciji.

Razvijalska dokumentacija Razvijalska dokumentacija vsebuje tehnični opis posameznih funkcionalnosti API-ja. Dokumentacija je na voljo izključno v angleškem jeziku.

Dostop do podpore Prek dostopa za podporo lahko razvijalci oddajo support requeste. Podporo za BKS Bank zagotavlja podjetje finAPI.

Produktivni XS2A vmesnik

Objava XS2A statistike

Support request je mogoče poslati tudi po elektronski pošti na xs2a-support@finapi.io.

XS2A fallback

Če pride do težav na strežniku XS2A ali če v časovnem oknu 30 sekund ni mogoče odgovoriti na zahtevanih pet poizvedb za:

  • dostop do informacij za izvajanje storitev odreditve plačil,

  • storitve informacij o računih,

se vrne eden izmed naslednjih 5xx statusnih kod:

  • HTTP 500 Internal Server Error,

  • 501 Not Implemented, 5

  • 02 Bad Gateway,

  • 503 Service Unavailable,

  • 504 Gateway Timeout,

  • 505 HTTP Version Not Supported,

  • 506 Variant Also Negotiates,

  • 507 Insufficient Storage,

  • 508 Loop Detected,

  • 510 Not Extended,

  • 511 Network Authentication Required ali

  • 599 Network Connect Timeout Error.

To daje TPP-ju pravico, da uporabi fallback pot. V tem primeru velja:

  • TPP mora poslati HTTP zahtevek z metodo GET

  • TPP mora priložiti veljaven produktiven QWAC certifikat

Klic: xs2a-fallback.bksbank-online.at/certificate-checker/cc

Če QWAC certifikat ni priložen ali preverjanje QWAC ni uspešno, se vrnejo naslednja sporočila o napaki:

  1. Klic brez certifikata HTTP 403 Forbidden { "timestamp": "...", "status": 403, "error": "Forbidden", "message": "Access Denied", "path": "/certificate-checker/cc" }

  2. Certifikat brez PSD2 razširitve HTTP 403 Forbidden { "errorMessage": "Certificate doesn't have qcExtensions section" }

  3. Status certifikata = revoked HTTP 403 Forbidden { "certificateStatus": "REVOKED" }

  4. Status certifikata = unknown HTTP 403 Forbidden { "certificateStatus": "UNKNOWN" }

Če je klic uspešen, sledi preusmeritev na prijavno stran BKS Bank. Pri tem se podatki iz certifikata posredujejo na prijavno stran.

Kako vam lahko pomagamo?

Naš center za pomoč strankam vam bo z veseljem pomagal. Na voljo smo vam od ponedeljka do petka od 8. do 16. ure.