The Complete Guide to testing apps & installing test BankID

Computer and mobile

General principles for personal data

  1. We should avoid real personal data (like SSN, email, telephone number, name, address...) in Sandbox whenever possible.

  2. If we need to use real personal data (for instance because Mobile BankID is needed for a 3rd party service like Tink, or because Sandbox forces us to use a real email) you must use our own personal data and delete them (offboard user) afterward when they are not needed anymore.

  3. Always create test users by following the instructions on this page.

  4. Never use fejk.se or other random personal info generators for generating Sandbox accounts

Equipment

What you need to follow the instructions:

Ikon föreställande en dator.

Computer

To bring up QR-codes you need to scan

Test user

Test user

To avoid using real SSN in Sandbox, Skatteverket publishes lists of correctly formatted but unused SSN, that can be used for Sandbox tests. For this purpose we recommend you use an SSN that is 18 years or older. By exporting the list as an excel-file, you can sort it by age. Keep in mind that all test personal numbers may be reused, Kivra does not delete shipments in the sandbox environment. Hence the importance of not sending any sensitive data during the tests.

You're now ready to use Kivra Sandbox

Congratulations! If you have followed all the steps correctly you are now ready to use Kivra Sandbox.

Get BankID

Note: To be able to test with Mobile BankID, you will need to use your own Mobile BankID, never someone else’s. Follow the following instructions after this.

Equipment

What you need to follow the instructions:

Ikon föreställande en dator.

Computer

To bring up QR-codes you need to scan

Ikon föreställande ett finger som klickar på en skärm.

Smartphone

to install our app and BankID

icon72-secure

Personal device

A personal device with mobile BankID installed.

A mobile phone with a notification about a new letter in Kivra.

Test user

To avoid using real SSN in Sandbox, Skatteverket publishes lists of correctly formatted but unused SSN, that can be used for Sandbox tests. For this purpose we recommend you use an SSN that is 18 years or older. By exporting the list as an excel-file, you can sort it by age. Keep in mind that all test personal numbers may be reused, Kivra does not delete shipments in the sandbox environment. Hence the importance of not sending any sensitive data during the tests.

iOS

If you want to issue a Test Mobile BankID on your iPhone it means you can not use your private Mobile BankID on the same device. In order to get past this you can login with a test Mobile BankID on an Android phone to run the Kivra test app on iPhone.

If you have a test iPhone make sure you delete a previous version of Mobile Bank ID and install it again.

  1. Make sure you have a test phone
  2. Download the Mobile BankID app from the App Store.
  3. Settings -> BankID -> Developer and enter cavainternal.test.bankid.com

Android

Install the latest version of Mobile BankID from Google Play Store (Android) or AppGallery (Huawei). Then configure the app as follows:

  1. Make sure you have a test phone.
  2. Put the phone in airplane mode.
  3. Launch the BankID app. (Dismiss any network failure warning or similar).
  4. Click on settings.
  5. Go to "About BankID".
  6. Make a "long press" (i.e. press and hold) on the heading "Error information".
  7. Enter kundtest in the box that appears.
  8. Exit the BankID app.
  9. Force quit the BankID app.

The BankID app is thus configured for the test environment.

Note that the BankID app cannot be run in emulated environments.

ID

Issue a Test Mobile BankID

Follow this link to issue a Test Mobile Bank ID. For this you will need a BankID from before.

In this example we use a production Mobile BankID which means that you use your personal Mobile BankID to identify yourself.

Note: When using the Test Mobile Bank ID you need a test user, as described above. Please follow the instructions under “Test User” above in creating your test user.

Issue test-BankID – step by step

  1. Click on Log in.
  2. Log in with a Production-BankID.
  3. Scan the QR with your private BankID.
  4. Issue BankID for test (choose Mobile BankID).
  5. Enter First name, last name and the SSN from Skatteverket Excel sheet.
  6. Open up BankID on your personal device and click on “QR-kod” and you will be able to scan the QR-code on the website. Sign with your code in your Mobile BankID app.
  7. Click on “Issue” below the heading “Issue BankID for Test”.
  8. Scan the QR code.
  9. You will get a message that the issue was successful and you can test it with the test app.
Sandbox external

Install Kivra test app for external users for IOS

Follow the steps to get a test app of Kivra on your iOS device:

  1. Download Testflight from App Store.
  2. In “native” settings of the app make sure you choose sandbox as the environment if you will use a Test BankID.
  3. Create an account in Kivra Sandbox
Android sandbox

Install the Kivra test app on Android

  1. Install the Kivra App from Google Play.
  2. Once installed make sure you run sandbox mode by choosing it in the setting of the first screen in the app.
  3. Create an account in Kivra Sandbox.

You're now ready to use Kivra Sandbox

Congratulations! If you have followed all the steps correctly you are now ready to use Kivra Sandbox.