How to register a new callback endpoint URL

Andrew-Indigo-Akita

I am trying to setup a new callback notification with my account that will send notifications to my specified URL when transctions are received into my account.
Is there an example of how to register such a callback anywhere, for example using curl? I'm struggling to find any clear instructions on how to create a new webhook notification endpoint - certainly it seems to be missing from both the docs and beta docs.

Thanks a lot

Bastiaan

Andrew You can also use the Postman collection: https://github.com/bunq/postman
And add new requests for the /v1/user/{userID}/notification-filter-url and/or /v1/user/{userID}/monetary-account/{monetary-accountID}/notification-filter-url endpoint.

For more info about this endpoints see this page: https://beta.doc.bunq.com/basics/callbacks

Andrew-Indigo-Akita

I attempted to register a callback using the bunq Desktop app, but encountered the following error when submitting my endpoint URL:
`Something went wrong
We failed to update your user information:

Superfluous field "notification_filters".

Response-Id: fbc40abb-d05e-425b-a05d-7852e73f643f`

Andrew-Indigo-Akita

Also attempted with the python tinker - same error

bunq.sdk.exception.BadRequestException: HTTP Response Code: 400
The response id to help bunq debug: 3964de47-01a6-47f7-b597-55c3a84f7826
Error message: Superfluous field "notification_filters".

wesselt

The Python tooling I made to synch with YNAB contains a toggle_callback.py function you could use.
https://github.com/wesselt/bunq2ynab

The API uses custom signing that is hard (but not impossible) to do with curl. Look for the X-Bunq-Client-Signature header in the documentation.

You got further with the SDK than I did, but the error message looks familiar. Sometime ago, bunq broke their own API by changing how the notification_filters field works. Looks like they haven't updated their tinker tool to reflect that.

Andrew-Indigo-Akita

Bastiaan Thank you both for your responses.

I attempted to use postman to set my endpoint url with the following GET request:

{{host}}/v1/user/{{user_id}}/notification-filter-url?category=PAYMENT&notification_target={{server_url}}

The above returns the following error:
{
"Error": [
{
"error_description": "The request signature is invalid.",
"error_description_translated": "The request signature is invalid."
}
]
}

I'm not too sure how to sign the request using postman. Would you be able to point me towards any resources on this?
Many thanks

Bastiaan

Andrew Hi Andrew

You have to perform a POST request instead of a GET.
The simplest way is to copy one of the other POST requests from bunq's Postman collection and change the URL of the new one.

For example:

ℹ Add your API key to the environment settings and run Create an installation, Add the device, Add a session before running the request above. For more info see https://github.com/bunq/postman or https://medium.com/bunq-developers-corner/the-bunq-api-starters-guide-6ce56b12d370

Andrew-Indigo-Akita

Bastiaan Perfect, thank you very much!