Authentication & environments
Configure API keys, choose an environment, and test payments inside the sandbox app.
Authorize requests
Send the API key in the X-Api-Key header. The console stores keys only in memory, separately for Sandbox and Production; refreshing clears them. “Authorize” saves the key for requests, and does not independently verify it. A successful authenticated request confirms access. Never put keys in query parameters or shared example code.
Sandbox and Production
Sandbox requests use https://sandbox-api.bink.fi. Production requests use https://api.bink.fi. Accounts, keys, tenants, and document IDs belong to their respective environments. The console defaults to Sandbox and requires confirmation before production writes.
Test payments in Sandbox
You can test payments inside the Bink sandbox app at sandbox.bink.fi. Start a payment in the app, choose a bank, and use the test credentials below on the bank’s test page. These credentials are for sandbox payment testing only.
| Bank | Username | Password | Personal identity code |
|---|---|---|---|
| Aktia | auto-filled | auto-filled | 010170-999R |
| OP | auto-filled | auto-filled | 070770-905D |
| Säästöpankki | 11111111 | 123456 | 010100A001N |
| POP Pankki | 11111111 | 123456 | 010100A001N |
| Danske Bank | 11111111 | 4545 | 280453-111A |
| OmaSP | 11111111 | 123456 | 010100A001N |
| Nordea | DEMOUSER1 | no password | 010200A9618 |
| Nordea | DEMOUSER2 | no password | 291292-918R |
| Nordea | DEMOUSER3 | no password | 030883-925M |
| Nordea | DEMOUSER4 | no password | 170677-924F |
| Ålandsbanken | 12345678 | 1234 | 410651-291U |
| S-Pankki | 12345678 | 1234 | 750240-1228 |
- auto-filled: use the values already supplied by the bank’s test page.
- no password: no password is needed for that test user.
Permissions
Document endpoints require a verified email and access to the tenant or document. API keys do not bypass resource permissions. A 401 means authentication failed; a 403 can mean missing access or an unverified email. Manage keys and webhook settings in the Bink application.