Guides

Sandbox

The sandbox institutions run the same API, the same Connect and the same sign-in rules as a real institution. Only the institution is fake, so you can try every path, failures included, without a real account.

A sandbox secret is offered the sandbox institutions and nothing else, and a live secret is never offered them. Their data is invented.

The sandbox bank

sandbox_bank is connected through Connect, like any institution whose runs_on is server.

Password: fi_wi for every persona. Any other password is refused as invalid_credentials.
One-time code: 123456, when a persona asks for one.
History: The current month so far and the 6 complete months before it, on the first sync. A persona, account and day always give the same transactions, under the same ids.
Sign-ins: 30 per hour per connection, more than a real institution allows, so you can test freely. The rules are a real institution's: see Syncing and budgets.
Connections: At most 25 at a time per key. Remove the ones you've finished with.

Balances are fixed figures, and don't add up from the transactions.

Personas

The username picks what happens.

Username	What happens	Error code
`jam_dung`	Connects, with accounts and 6 months of history.	—
`user_remittance`	Connects, with 6 months of remittances, cash paid in and bills, and no salary.	—
`user_joint`	Connects, as jam_dung, but the first account has two holders and the person who signed in is the second, with no address on file.	—
`user_otp`	Asks for a code by text. `123456` connects; after 3 wrong codes the attempt ends.	—
`user_blocked`	Connects, with `unattended_blocked` set: this connection can't sync without the person.	—
`user_locked`	Refused at connect, whatever the password, as a locked account is.	`account_locked`
`user_down`	Refused at connect. Retryable, and nothing is stopped.	`institution_down`
`user_broken`	Refused at connect: AlkiraiLink couldn't read the institution's answer.	`connector_broken`
`user_expires_at_sync`	Connects. Every sync fails, from the first, and the connection stops.	`session_expired`
`user_down_at_sync`	Connects. Every sync fails as retryable, from the first, and nothing stops.	`institution_down`
`user_broken_at_sync`	Connects. Every sync fails, from the first, and the connection stops.	`connector_broken`

A sync-time persona fails from the very first sync. Accounts read during the connect are still served for 15 minutes, as they are at a real institution, so try a sync rather than a list of accounts.

The sandbox statement bank

sandbox_statements is the sandbox's client institution: the person signs in on their own device, through the mobile SDK, and your server reads the statements it exports. Use it to try a sign-in sync end to end.

Every persona takes the password fi_wi and the code 123456. They are typed into the fake institution's page and never leave it.

Username	What happens
`jam_dung`	Two deposit accounts and a card.
`user_signout_fails`	As jam_dung, but the institution's sign-out fails.
`user_session_ends`	As jam_dung, but the session ends 40 seconds after sign-in, partway through a sync.