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
- 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öoikeusRajaukset
- 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
| Suunta | Kyvykkyys |
|---|---|
| Ulos | AlkutilioteUusi rekisteröinti luo listattavan ja ladattavan camt.053.001.02-aineiston. |
| Sisään | Allekirjoitettu maksuHyväksyy paikallisesti allekirjoitetun synteettisen pain.001.001.09-aineiston. |
| Ulos | PalauteaineistotTuottaa 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.