We do not use real money and do not allow external transactions in the sandbox environment.
You need to create a sandbox user to test the bunq API. The easiest way to do it is by using our developer portal:
Log in using your bunq account or create a free developer account with sandbox-only access.
Go to Sandbox Users.
Generate up to 5 users.
Use the sandbox API key to create an API context and/or use the user credentials to log in to the sandbox bunq app.
There are 3 other ways you can generate a bunq sandbox API key:
connect to Tinker (it will also return login credentials for the sandbox app);
create it in the sandbox app (you need to be logged in as a sandbox user);
call the sandbox user endpoints directly, using our Postman collection, or by running a cURL command (change sandbox-user-person
to sandbox-user-company
to generate a business user):
curl https://public-api.sandbox.bunq.com/v1/sandbox-user-person -X POST --header "Content-Type: application/json" --header "Cache-Control: none" --header "User-Agent: curl-request" --header "X-Bunq-Client-Request-Id: $(date)randomId" --header "X-Bunq-Language: nl_NL" --header "X-Bunq-Region: nl_NL" --header "X-Bunq-Geolocation: 0 0 0 0 000"
Once you have a sandbox API key, create more sandbox users to use as test customer accounts, and start playing with the API.
The sandbox base URL is https://public-api.sandbox.bunq.com/v1/
.
Without money, it's not always sunny in the sandbox world. Fortunately, getting money on the bunq sandbox is easy. All you need to do is ask Sugar Daddy for it.
Send a POST v1/request-inquiry request passing sugardaddy@bunq.com in the counterparty_alias
field. Specify the type
for the alias and set the allow_bunqme
field. Request up to €500 at a time.
{"amount_inquired": {"value": "100","currency": "EUR"},"counterparty_alias": {"type": "EMAIL","value": "sugardaddy@bunq.com","name": "Sugar Daddy"},"description": "You're the best!","allow_bunqme": false}