The complete guide for testing Kivras app / webb

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 you need to use real personal data (for instance because Mobile BankID is needed for a 3rd party service like Tink, or because Sandbox forces you 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 Sandbox accounts

Equipment for testing our web-interface

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 a real social security number (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 SSN may be reused and Kivra does not delete content in the sandbox environment. Hence the importance of not sending any sensitive data during the tests.

Follow the instructions to activate a test user on the web.

  1. Download a test social security number via the "Test-SSN" link below, on the Tax Agency's website, select CSV File.
  2. Send an email to avsandare.support@kivra.com and ask to receive an activation code for the test SSN you have chosen.
  3. After receiving an activation code from us, register your account via https://sandbox-accounts.kivra.com/register.
  4. Once the account has been activated, log in at https://sandbox-accounts.kivra.com/auth with the email address and password chosen during registration. 

Note: Only one email address can be used per account. Only a real phone number is valid. Save the login details so you and your colleagues can reuse the test account in the future.

You're now ready to use Kivra Sandbox

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

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 a real social security number (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 SSN may be reused, Kivra does not delete content 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. This step requires that you have a real Mobile BankID to begin with.

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 registration 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, you are now ready to use Kivra Sandbox.