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
Beta
  • 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 Banksimulatorn

Avgrä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

RiktningFunktion
UtFörsta kontoutdragEn ny registrering skapar en camt.053.001.02-fil som kan listas och hämtas.
InSignerad betalningTar emot en lokalt signerad syntetisk pain.001.001.09-fil.
UtResponsfilerSkapar 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.

Ditt meddelande

Hur kan vi hjälpa?

Namn krävs och kan bara innehålla bokstäver
Ange en giltig e-postadress
Meddelandet måste vara minst 10 tecken långt