Android Emulator

It is not possible to create accounts using the regular signup in the app, bunq is not reviewing Sandbox applications. See Creating a sandbox user and getting an API key to learn how to get a user you can test with.

In case you do not own an Android device on which you can run our Sandbox app for end-to-end testing, you can set up an emulator to run the bunq Sandbox app for Android.

Things you will need

You can choose to install on a physical or virtual device.

• For a physical device you'll need a modern Android Device

• If you want to virtualize the bunq app on your computer you need to install Android Studio.

Download sandbox app

Download the APK file from an Android device to install it on that device

Download APK File

Starting the Android Virtual Device (AVD) Manager

1. Open Android Studio.

2. From the top menu, select “Tools” > "Android" > "AVD Manager".

Setting up a new virtual device

1. Start the wizard by clicking on "+ Create Virtual Device".

2. Select a device (we recommend: "Pixel 5.0" or "Nexus 6") and press "Next".

3. Select an x86 system image (we recommend: Nougat, API Level 25, Android 7.1.1 with Google APIs) and press "Next". The image needs to have Google Play Services 10.0.1 or higher.

4. In the bottom left corner, select "Show Advanced Settings".

5. Scroll to "Memory and Storage".

6. Change "Internal Storage" to "2048 MB".

7. Change "SD card" to "200 MB".

8. Press "Finish".

Starting the virtual device

1. On the right side under "Actions", select the green "Play" button.

2. Wait for the device to boot, this may take a few minutes.

Installing the bunq Sandbox App APK

1. Open the command line.

2. Navigate to your Android SDK platform tools directory (e.g. cd ~/Library/Android/sdk/platform-tools on macOS).

3. Make sure that the virtual device is started and has fully booted.

4. Run ./adb install ~/Downloads/bunq-android-sandboxEmulator-public-api.apk, this may take a few minutes, and should finish with "Success".

Creating an account and logging in

1. Create a sandbox user through the portal

   1. Create a sandbox account in the developer portal.

   2. Grab the API key from the portal

2. Create a user through the API

3. With the API key Start a Session. This will return a User which has an alias attached. The Alias is a fake email address or phone number. All pass codes are either 000000 or 992266

You will be asked to verify your phone number when you open the app for the first time. Sandbox does not send actual SMS messages. Enter any valid phone number and use the default verification code 992266.