ISECure REST API · testiympäristö

Pankkisimulaattori

Aloita koko maksuaineistopolun testaus jo sillä aikaa, kun oikea pankkisopimus ja tuotantovarmenteet ovat vielä työn alla. Pankkisimulaattori käyttää nykyistä File Exchange API:a ja TypeScript SDK:ta pankkitunnisteella simulator.

Perusosoite
https://ws-api.test.isecure.fi/v2
Pankki
simulator
Beta
  • TestiympäristöRekisteröinti vaaditaan · Maksullinen tilaus vaaditaan · Pyydä käyttöoikeus

Tarkka tila ja rajaus

Testiympäristö

Vain pankille simulator osoitteessa https://ws-api.test.isecure.fi/v2. Simulaattorievidenssi ei todista oikean pankin toimintaa.

Pyydä pankkisimulaattorin käyttöoikeus

Rajaukset

  • Vain synteettinen testidata.
  • Ei pankkisopimusta, tuotantokanavaa tai oikeaa maksua.
  • Nykyinen tili, alkusaldo ja oletusskenaario ovat kiinteitä; asiakas ei vielä määritä pankkeja, tilejä, valtuutuksia tai skenaarioita.

Mitä voit testata nyt

Voit rekisteröidä testivarmenteen, ladata alkutiliotteen, lähettää paikallisesti allekirjoitetun pain.001.001.09-aineiston ja noutaa synteettiset pain.002-, camt.054- ja päivitetyt camt.053-aineistot ennen oikean pankkiyhteyden valmistumista.

Kun pankkisopimus, tunnukset ja tuotantovarmenteet ovat valmiit, täsmälleen sama File Exchange API kohdistetaan erikseen määritettyyn ja pätevöityyn oikeaan pankkiyhteyteen. Pankkisimulaattori säilyy testikohteena; korvattavaa toista pankkiyhteysintegraatiota ei ole.

Ympäristö ja rajapinta

Testiympäristön osoite on https://ws-api.test.isecure.fi/v2. Simulaattori on käytettävissä vain ISECuren testiympäristössä.

Käytä samoja rekisteröinti-, kirjautumis-, varmenne- ja tiedosto-operaatioita kuin muille pankeille. TypeScript SDK:ssa ei ole simulaattorikohtaisia metodeja; valitse asiakasasetuksissa Bank: "simulator".

Varmenteen rekisteröinti

Simulaattorin WS-käyttäjätunnusta tai PIN-koodia ei noudeta erillisestä palvelusta. Luo arvot omassa testisovelluksessa ja lähetä ne nykyisellä enrollCert-operaatiolla. Company-arvon tulee vastata rekisteröityä testitiliä.

  • WsUserId: 1–16 tavua tulostettavaa ASCII-tekstiä ilman ohjausmerkkejä
  • Code: 16–32 tavua tulostettavaa ASCII-tekstiä ilman välilyöntejä tai ohjausmerkkejä
  • Arvot ovat lyhytikäistä testitietoa eikä niitä pidä tallentaa lähdekoodiin tai lokiin

Ensimmäinen tiliote

Tuore suora rekisteröinti luo yhden NEW-tilassa olevan camt.053.001.02-tiliotteen. Se sisältää synteettisen tilin FI2112345600000785, 10 000 000,00 euron OPBD- ja CLBD-saldot eikä tapahtumia.

Listaa tiedosto FileType-arvolla camt.053.001.02 ja Status-arvolla NEW, ja lataa palautettu läpinäkymätön FileReference downloadFile-operaatiolla. Uusi lataus palauttaa samat tavut; tila vaihtuu NEW-arvosta DLD-arvoon ja tiedosto näkyy edelleen ALL-listauksessa.

Allekirjoitettu maksuaineisto ja palaute

Luo OpenPGP-avainpari paikallisesti, rekisteröi vain julkinen avain authorize-käyttöön ja allekirjoita synteettinen pain.001.001.09-aineisto omassa sovelluksessa ennen uploadFile-kutsua.

Hyväksytty lähetys tuottaa listattavaksi ja ladattavaksi seuraavat synteettiset aineistot:

  • pain.002.001.10 maksun tilapalautteena
  • camt.054.001.02 veloitusilmoituksena
  • uusi camt.053.001.02 päivitettynä tiliotetietona

Tenanttikohtainen tila

Simulaattorin yhteys, tiedostoviitteet ja aineistot kuuluvat vain ne luoneelle ISECure-tenantille. Toinen asiakas ei voi listata, ladata tai muuttaa niitä.

Mitä et voi vielä määrittää

Nykyinen Beta-versio käyttää yhtä kiinteää synteettistä tiliä, alkusaldoa ja determinististä oletusskenaariota.

  • Ei asiakkaan määrittämiä simulaattoripankkeja, tilejä tai alkusaldoja
  • Ei WebServices-käyttäjien, tiedostotyyppien, suuntien tai profiilien valtuutusasetuksia
  • Ei asiakkaan skenaarioita, virheitä, katkoaikoja, virtuaaliaikaa tai haaroja

Kyvykkyydet ja suunta

SuuntaKyvykkyys
UlosAlkutilioteUusi rekisteröinti luo listattavan ja ladattavan camt.053.001.02-aineiston.
SisäänAllekirjoitettu maksuHyväksyy paikallisesti allekirjoitetun synteettisen pain.001.001.09-aineiston.
UlosPalauteaineistotTuottaa pain.002.001.10-, camt.054.001.02- ja päivitetyn camt.053.001.02-aineiston.

Usein kysyttyä

Tarvitaanko erillinen simulaattori-SDK?

Ei. Käytä samoja REST-operaatioita ja TypeScript SDK:ta pankkiasetuksella simulator.

Voinko käyttää Processing API:a ennen simulaattoria?

Kyllä. Processing API voi valmistella tarkistetun pain.001-aineiston erillisessä istunnossa. Sovelluksesi tarkistaa ja allekirjoittaa sen paikallisesti ennen lähetystä pankille simulator. Nykyiset esimerkit ovat erillisiä eikä palaute täsmäydy automaattisesti.

Voivatko asiakkaat nähdä toistensa tiedostot?

Eivät. Simulaattorin yhteys, tiedostoviitteet ja aineistot ovat tenanttikohtaisia.

Viestisi

Miten voimme auttaa?

Nimi on pakollinen ja voi sisältää vain kirjaimia
Anna kelvollinen sähköpostiosoite
Viestin tulee olla vähintään 10 merkkiä pitkä