Hi everyone, 👋
Every now and then I see some questions regarding the setup of a new API project. I wrote a step-by-step guide which should explain how to get started with your own API project on the Sandbox environment. Included are the activation of the Android Sandbox app and the creation of your users to test with. I hope this will help some of you to get started more easily.
There’s a couple of things you will need to do to get started;
- Get the app
Get the bunq Sandbox app from this link (you can use the Emulator in case you have an iPhone, instructions for this can be found on doc).
- Activate the app
Enter a random phone number. The Sandbox environment will not send actual text messages to your phone. You can use the code
123456 to verify the random phone number.
If the phone number has been chosen by another bunq user before you might get a notification asking you whether you want to kill previous sessions.
- Get a user
Follow the instructions to install any of the Tinker projects on your machine. When the installation succeeded run the script
tinker/user-overview. This will result in some data on your screen, among which you will find your login credentials.
- Login to the Sandbox app
You can now log in in the app, use either the combination of phone number and login code, or the combination of email address and login code. When you are asked to scan your hand you can just scan your own hand; on Sandbox the hand scan accepts every hand.
- Ready to get things done
You can now create OAuth / API Key connections as you would with the regular app. To make API keys distinguishable from real API keys, API keys issued on Sandbox start with
- OAuth URLs
OAuth on Sandbox is accessible as well. Sandbox uses dedicated URLs for OAuth, which you can find at:
- Signing up through the Sandbox app is not possible
Signing up new users in the Sandbox app is not possible, there are no employees monitoring the new registrations.
- Support chats won't be answered
Like new registrations, support chats are not monitored on Sandbox.
- Getting "fake" money
In need of money? Send a Request to firstname.lastname@example.org, max 500€ / time). This request will immediately be accepted. You can repeat this as often as you want to fill your account. (no, this does not work in the real app) ;-)
Cards are obviously not delivered, hence it’s currently not possible to activate them.
- Creation fake card transactions
It is not possible to create your own ‘fake’ card transactions.
- Backdating transactions
It is not possible to ‘backdate’ transactions.
- Dedicated API key per environment
Sandbox and Production are completely separate. Hence, your API keys will only work on the environment they were created for.
In case you run into any problems you can always open an issue on GitHub in the respective repository, contact Private Matters or open a topic here on Together. 🙂
Happy coding. 🌈