Webhook S2S Postback

A Postback URL (or WebHook) is used by Publishers to receive conversions on their back-end servers and handle the reward to the users.

To set up a Postback URL in our Platform, go to Settings section and find the Postback URL section on the left.

Here you can edit your URL and add parameters. Click the Add Parameter button to add more.

Make sure your URL is in a valid form:

https://yourdomain.com/?user_id={user_id}&payout={payout}...

On the right, you’ll see a list of Macros that are available to use in your Postback URL.

You can use the "Add Parameter" button to help you creating your Postback URL.

Once you are done, click on Save Postback URL.

Important Notes

Please ensure the following requirements are met:

1. Parameter Parsing Verify that your endpoint correctly parses all parameters in the Postback.

2. IP Whitelisting Add all MAF postback IP addresses to your whitelist. In the next section (“Validating the S2S Webhook”) we will explain in detail how to configure this.

3. Support for CPI Bidding Postbacks

   • For CPI bidding offers, the publisher is paid only upon install.

   • For all subsequent events, your system must not reject postbacks with:

     • payout = 0

     • user_payout = $X Ensure your platform supports this type of postback.

4. Reward Calculation

   • Do not use the virtual currency parameter ({user_payout_in_vc}) to calculate rewards.

     • This parameter is provided for informational purposes only.

   • For accurate reward calculation, you must rely on one of the following parameters:

     • user_payout

     • payout – the recommended parameter for reward calculation.

   • Reward conversion logic and final computation must always be handled on your side, based on either the user_payout or, preferably, the payout parameter.