🛡️Setup S2S Postback

You can configure the S2S postback for the application in the dashboard while adding new app inside manage app section.

Setting Up Postback URL

We fire an HTTP GET request to the provided postback URL. The following query parameters will be consider.

//Example URL

https://www.example.com/postbacks/postback_file_name.php

Query Params	Description
user_id	Unique identifier of the user from your app.
offer_id	The identifier of the offer for which the user receives a postback.
offer_name	The name of the offer for which the user receives a postback.
payout	The amount earned per completed milestone by publisher.
amount	The value of the reward earned by the end user.
signature	Hash of the above values to verify the request
task_name	The name of task for which user receives reward (for level or playtime offers)
task_id	The id of task for which user receives reward (for level or playtime offers)
currency_name	The currency name you have set will be sent to you in this variable in the postback.

Example

user_id = 123

offer_id = 123

offer_name = Test_game

payout = 500

amount= 250

signature = 45786sdg458-sdg465-659s465sdg-465ery98bm

task_name = Complete_level_X

task_id = 162657

currency_name = Coin

PostbackURL -> https://www.example.com/postbacks/postback_file_name.php?user_id=123&offer_id=123&offer_name=Test_game&payout=500&amount=250&signature=45786sdg458-sdg465-659s465sdg-465ery98bm&task_name=Complete_level_X&task_id=162657&currency_name=Coin

Sample code to validate request

PHP

 // Signature Authentication
 
 $userId = $_REQUEST['user_id'];
 $offer_id = $_REQUEST['offer_id'];
 $coin_amount = (int)$_REQUEST['amount'];
 $signature = $_REQUEST['signature'];
 $task_id = $_REQUEST['task_id'];
 $task_name = $_REQUEST['task_name'];
 $currency_name = $_REQUEST['currency_name '];

 $calculated_signature = sha1($userId.$offer_id.$coin_amount."YOUR_APPLICATION_KEY"."YOUR_APPLICATION_SECRET_KEY");
 
 if($signature === $calculated_signature){
 // Request is valid
 }

Test Callback Tool

We provide a dedicated Test Callback Tool so you can safely verify your callback configuration before going live.

Key Features:

• Safely test your callback URL without affecting live data.

• Instantly simulate user actions and reward payouts.

• Debug and validate parameters directly from the dashboard.

Input Fields:

• User ID → Simulates a user session.

How It Works:

1. Enter the User ID (this must match the User ID used in your SDK initialization).

2. Click Send Test Postback.

ℹ️ Note: Make sure the callback endpoint is correctly configured to receive and validate all required parameters.

Points to keep in mind while setting up postback URL

• All parameters are append from our side publisher has to give only path to their postback file.

• Value of amount passed in postback is converted in your given app currency at your given currency rate in exchange of 1$.