Global Postback
Global Postback
For every offer complete, we will make a call to the Global Postback URL that you indicated in your account settings. We will attach the information that you have required when completing the postback url.
Our server will make a HTTP GET request to your server including the parameters that you have added. Here is the list of available macros.
Parameter | Description |
---|---|
{user_id} | This is the unique identifier code of the user who completed action on your platform. |
{status} | Determines whether to add or subtract the amount of the reward. "0" is when the virtual currency should be added to the user and "1" when it should be subtracted. This may be because the advertiser has canceled the user's transaction, either because he/she committed fraud or because it has been a mistake entering the data needed to complete the campaign. |
{transaction_id} | Unique identification code of the transaction made by your user on the offerwall. If an offer is rejected we will send a postback with the same transaction ID but with status "2". |
{offer_id} | Id of the offer completed. |
{offer_name} | Name of the offer completed. |
{event_id} | Id of the event in an offer completed (if the offer is multiple levels). |
{event_name} | Name of the event in an offer completed (if the offer is multiple levels). |
{ip} | The user's IP address who completed the action. |
{payout} | The offer payout in $ |
{signature} | MD5 hash that can be used to verify that the call has been made from our servers. |
Forming the postback URL
Our system IP is, 0.0.0.0 you should accept only postbacks coming from this IP address.
As we use macros to build the postback URL, it's as simple as incorporating each macro in the place corresponding to the parameter value you want in the URL to which you want us to call. This way, you can use parameter names of your choice.
In the following example, we have decided to receive the revenue in the parameter "money" and the transaction ID in the parameter "leadId".
https://exampleurl.com/postback/?money={payout}&leadId={transaction_id}