Skip to main content

API Testing

Updated over a month ago


Test Registration

Here you can run tests for specific campaigns and test your integration with the brand.

  • You can see the full brand response.

  • You can test a lead for a specific campaign.

  • You can test a lead for a specific box.

    Open the bottom-left menu and search for API Testing:

- Choose campaign, affiliate, and country.
- Click on 'autofill user data', on both user data and free parameters if needed.
- Click on 'Test Lead'.


1. If you want to check a specific lead, or the full brand response - copy the email for the lead and after you fill in all the auto data change the email for the lead that you want to check.

2. Select the campaign and the country you want to test. If you want to send the test to a box, fill the box's gi in the 'box' field.



​Request & Response

On the right side of the screen after sending a test you will see the API request and API response of the specific test lead to the brand.

Request:

Although the request contains mostly irrelevant info to the brand it can help you / the support agents understand what happened with the API requests in case of failures.

In most cases the relevant request info to the brand can be found at the top under "main" as seen in the picture right up to "requestFormat" parameter which can also be important to the brand.

Response:

The response divides into 2 main sections

  1. Brand API Response

  2. Trackbox API Response

The Brand API Response shows you the response we got from the brand inside the "body" parameter.

The Trackbox API Response shows if we failed the lead or passed it on our side (so in cases you see the brand response looks okay but the "status" is not "true" in the Trackbox API Response contact our support to check the specific integration).

In cases where you see a failed lead you share the relevant info from request and response as we discussed and the brand will advise how to proceed.


Autologin

In The Trackbox API Response section you can see the second parameter "data"

Which will have the "masked" (we hide the real brand url from your affiliates) autologin url that we generate according to the brand API documentation.

Some brands return an autologin url, some ask us to generate from a separate API method and some do not even have autologin.

In order for autologin to be used properly the link inside "data" parameter must be entered (it is a one-time link) and then the autologin will be shown as used in your leads screen and on brand side if everything is okay with the autologin parsing on our side.

Note:

You can see the real brand autologin inside the "autoLoginUrl" parameter but using the autologin from there will only trigger the usage on brand side and not Trackbox.



Pull Testing


If you don't see status / deposit from the brand, Go to:

  • Select the tab 'Pull test'

  • Choose the brand and the method (Lead/ FTD), and time back

  • Compare the customer id the lead received from the brand (you can get it via CRM by clicking on the lead) and the outcome from the brand's API.

Did this answer your question?