Testing callbacks

Learn how to test your callbacks.

Callback Tester

Once you have configured your callbacks, you can start testing your endpoint using our Callback Tester. You can find it on Your App Name > Integration. When you are scrolling down, you will find a button that says "Open Callback tester":


Click on this button to open the Callback Tester modal:


Specifying the opening URL

The callback tester can be used for any integration type (iframe, SDK, API, and so on). However, it will still require an opening URL that is typically only used for iframe integrations. The opening URL is a link that will open the BitLabs offer wall. You can add additional custom query parameters to the URL that you would like to receive in the callbacks. One example of an opening URL would be:

https://web.bitlabs.ai?token=07ab2c56-af6a-4ee1-b96c-2c376b47bd51&UID=TestUser&mycustomparameter=123

In this example, we specify the token, UID (your user ID), and a custom query parameter, which you will receive in your callbacks. You can learn more about custom parameters here.

If you don't want to pass in custom parameters or a UID, then leave the URL as is.


Testing callbacks

We offer a variety of different callback test cases. Select a case you want to test, and then click on the button. BitLabs will then call your configured callback endpoint and show the response on the top of the modal. If the response shows an error, that means that your endpoint has an issue and it needs to be resolved from your end.


📘

The callback will include a debug=true parameter, so you can make sure that it won't impact your production environment.

When you make changes to your callback URLs, make sure to save the changes before testing callbacks again.