🛡️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.phpuser_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¤cy_name=Coin
Sample code to validate request
// 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($.$.$.""."");
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:
Enter the User ID (this must match the User ID used in your SDK initialization).
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$.
Last updated