ISECure REST API · testmiljö
Banksimulator
Börja testa hela betalningsfilflödet medan det riktiga bankavtalet och produktionscertifikaten fortfarande är under arbete. Banksimulatorn använder det befintliga File Exchange API:t och TypeScript SDK:t med bankidentifieraren simulator.
- Basadress
https://ws-api.test.isecure.fi/v2- Bank
simulator
- TestmiljöRegistrering krävs · Betald prenumeration krävs · Begär åtkomst
Exakt status och omfattning
Testmiljö
Endast för banken simulator på https://ws-api.test.isecure.fi/v2. Simulatorevidens bevisar inte en riktig banks beteende.
Begär åtkomst till BanksimulatornAvgränsningar
- Endast syntetiska testdata.
- Inget bankavtal, ingen produktionskanal och ingen riktig betalning.
- Det nuvarande kontot, startsaldot och standardscenariot är fasta; kunder kan ännu inte konfigurera banker, konton, behörigheter eller scenarier.
Vad ni kan testa i dag
Ni kan registrera ett testcertifikat, hämta ett första kontoutdrag, ladda upp en lokalt signerad pain.001.001.09 och hämta syntetiska pain.002-, camt.054- och uppdaterade camt.053-filer innan den riktiga bankanslutningen är klar.
När bankavtalet, inloggningsuppgifterna och produktionscertifikaten är klara riktas exakt samma File Exchange API-kontrakt mot den separat konfigurerade och kvalificerade riktiga bankanslutningen. Banksimulatorn finns kvar som testdestination; det finns ingen andra bankanslutningsintegration att ersätta.
Miljö och gränssnitt
Testmiljöns basadress är https://ws-api.test.isecure.fi/v2. Banksimulatorn är tillgänglig endast i ISECures testmiljö.
Använd samma registrerings-, inloggnings-, certifikat- och filoperationer som för andra banker. TypeScript SDK:t har inga simulatorspecifika metoder; välj Bank: "simulator" i klientkonfigurationen.
Registrera certifikatet
Det finns ingen separat tjänst för att hämta simulatorns WS-användar-ID eller PIN-kod. Skapa båda värdena i testapplikationen och skicka dem med den befintliga enrollCert-operationen. Company måste motsvara det registrerade testkontot.
- WsUserId: 1–16 byte utskrivbar ASCII utan kontrolltecken
- Code: 16–32 byte utskrivbar ASCII utan blanksteg eller kontrolltecken
- Behandla båda som kortlivade testvärden och håll dem borta från källkod och loggar
Hämta det första kontoutdraget
En ny direktregistrering skapar ett camt.053.001.02-kontoutdrag med status NEW. Det innehåller det syntetiska kontot FI2112345600000785, lika OPBD- och CLBD-saldon på 10 000 000,00 EUR och inga poster.
Lista det med FileType camt.053.001.02 och Status NEW och skicka sedan den ogenomskinliga FileReference som returneras till downloadFile. Upprepad hämtning returnerar identiska byte; statusen ändras från NEW till DLD och filen är fortfarande synlig under ALL.
Ladda upp en signerad betalning och hämta respons
Skapa ett OpenPGP-nyckelpar lokalt, registrera endast den publika nyckeln för authorize-användning och signera en syntetisk pain.001.001.09-fil i applikationen innan uploadFile anropas.
En godkänd uppladdning skapar följande syntetiska filer för listning och hämtning:
- pain.002.001.10 som betalningsstatus
- camt.054.001.02 som debetavisering
- en ny camt.053.001.02 med uppdaterade kontoutdragsdata
Tenant-specifikt tillstånd
Simulatoranslutningen, filreferenserna och filerna tillhör endast den ISECure-tenant som skapade dem. En annan kund kan inte lista, hämta eller ändra dem.
Vad ni ännu inte kan konfigurera
Den nuvarande Beta-produkten använder ett fast syntetiskt konto, startsaldo och deterministiskt standardscenario.
- Inga kunddefinierade simulatorbanker, konton eller startsaldon
- Ingen konfiguration av WebServices-användare eller behörighet för filtyp, riktning eller profil
- Inga kundskapade scenarier, fel, bryttider, virtuell tid eller grenar
Funktioner och riktning
| Riktning | Funktion |
|---|---|
| Ut | Första kontoutdragEn ny registrering skapar en camt.053.001.02-fil som kan listas och hämtas. |
| In | Signerad betalningTar emot en lokalt signerad syntetisk pain.001.001.09-fil. |
| Ut | ResponsfilerSkapar pain.002.001.10, camt.054.001.02 och en uppdaterad camt.053.001.02. |
Vanliga frågor
Behöver simulatorn ett separat SDK?
Nej. Använd samma REST-operationer och TypeScript SDK med bankinställningen simulator.
Kan jag använda Processing API före simulatorn?
Ja. Processing API kan förbereda den kontrollerade pain.001-filen i en separat session. Er applikation verifierar och signerar den lokalt före uppladdning till banken simulator. De nuvarande exemplen är separata och responsen korreleras inte automatiskt.
Kan kunder se varandras filer?
Nej. Simulatoranslutningar, filreferenser och filer är tenantspecifika.