Integrate with the PSD2 bunq API
Extend your coverage across the EU by connecting your product to bunq!
Power your application with account data as an AISP, payment initiation as an PISP or card balance check as a CBPII.
Integrate fast using our SDKs
Save time on figuring out the authentication flow
Catch up with API upgrades in 5 minutes
Connect to the API by just passing the QSEAL certificate, QSEAL certificate chain and QSEAL private key
Choose your language
Python
Click to copy!$ https://github.com/bunq/sdk_python
Click to copy!
Java
Click to copy!$ https://github.com/bunq/sdk_java
Click to copy!
PHP
Click to copy!$ https://github.com/bunq/sdk_php
Click to copy!
C#
Click to copy!$ https://github.com/bunq/sdk_csharp
Click to copy!
FAQs
What certificate types does bunq accept?
We accept QSEAL certificates.
How do I get an API key as a PSD2 user?
You’ll receive a token in return to passing your QSEAL certificate. You’ll then be able to use it as an API key.
What do I need to register my QSEAL certificate?
You need to send a POST /payment-service-provider-credential request passing your
QSEAL certificate, QSEAL certificate chain, and a signature of the device registration key with the QSEAL private key. Check the full authentication flow here.
How does the PSD2 API request signing work?
The request signature requirement is the same for all types of API users. You can read more about it here.
How do I get an OAuth client as a PSD2 user?
You can create an OAuth Client using POST /user/userId/oauth-client and read it using its id (GET /user/userId/oauth-client/oauth-clientId). Once you have it, you can add a redirect url using POST /user/{userID}/oauth-client/{oauth-clientID}/callback-url. From there, you can move to creating an authorization request and token exchange.
Where do I find the AISP, PISP and CBPIII API reference?
bunq offers one API to both our users and companies with PSD2 permit: https://doc.bunq.com/. As a PSD2 party, you can only access the endpoints that correspond with your permit level.
Are the AISP, PISP and CBPIII APIs the same API as I use as a bunq user?
Yes, the only thing that differs is the authentication flow. Everything else is the same.
I need help with the PSD2 API. How do I get support?
Our API documentation will help you get started. If you need dedicated guidance or troubleshooting for a problem you are experiencing, you can purchase a 10-hour dedicated support package. You can request this service at apipartner@bunq.com.