IzeAdsHelp

Webhook Integration

Set up webhooks to receive payment events

Payment platform integration via webhook

IzeAds integrates with the main Brazilian and international payment platforms via webhook. When a sale is made, the payment platform sends a notification to IzeAds, which associates the sale with the tracked visitor and fires the Purchase event on the Facebook Conversions API.

Supported platforms

  • Kirvano
  • Hotmart
  • Kiwify
  • Eduzz
  • Monetizze
  • PerfectPay
  • Braip
  • Velyst
  • Digistore24

Step by step

1

Go to the Integrations page

In the sidebar menu, click "Integrations". You will see the list of available platforms.

2

Select the platform

Click the payment platform you use. IzeAds will generate a unique webhook URL for your company.

3

Copy the webhook URL

Copy the displayed URL. It will be in the format: https://yourdomain.com/webhook/{token}. This token is exclusive to your integration.

4

Configure the webhook on the payment platform

Access your payment platform panel (e.g., Kirvano, Hotmart) and locate the webhooks or notifications section. Paste the copied URL and enable sale notifications.

5

Test the integration

Make a test purchase (if the platform allows) or wait for the next real sale. Check in the tracker dashboard whether the Purchase event was registered.

src parameter (tracking parameter)

For IzeAds to associate the sale with the correct visitor, the src parameter must contain the SCK (session identifier) generated by the tracking script. This parameter is automatically added by the script to the checkout URL. Make sure your checkout page passes the src parameter from the URL to the payment platform.

Testing webhooks

After configuring, go to the tracker details page and monitor the events tab. When a sale is processed, you will see the Purchase event with the transaction value. If the sale appears as "orphan", verify that the src parameter is being correctly passed in the checkout URL.

Orphan sales

If the webhook arrives without a valid SCK (src parameter empty or missing), IzeAds will register the sale as "orphan". The sale will still be counted in total revenue, but will not be associated with a specific visitor session. To avoid orphan sales, make sure the tracking script is correctly installed and that the checkout URL contains the src parameter.