Postback
This page will guide you through the integration of Revlum Postback
What is a Postback?
A postback allows you to receive notifications on your server every time your account receives a conversion. This is necessary for you to be able to provide your users with rewards. For example, whenever you receive a conversion, you may wish to be notified what the payout, user ID, and point value are. We are also able to send you a postback in the case that a lead may be reversed.
GET Method
http://yoururl.com/postback/?user={subId}&transaction={transId}&reward={reward}&payout={payout}&name={offerName}
We will replace all of the macros, such as {subId}, with the actual value (such as "user21".) On your server, you will read the "user" GET variable to retrieve this macro's value.
| Parameter | Description | Example |
|---|---|---|
| {subId} | Unique user identifier, passed by publisher. | revlum1 |
| {sub1} | Additional subId that can be passed in the tracking link | revlum |
| {transId} | Use this to prevent double conversions. | REV-351 |
| {offerName} | Name of the completed offer. | Revlum - Sign up and Earn |
| {offerId} | Id of the completed offer. | 1354 |
| {event_id} | Id of the completed offer event (empty if base event). | bhf38ysj18 |
| {event_name} | Name of the completed offer event (empty if base event). | Reach lvl 1 |
| {reward} | User reward in app currency | 25.0 |
| {reward_name} | The name of your in app currency. | Coins |
| {payout} | Complete payment in USD, paid to the publisher. | 0.10 |
| {userIp} | The user's IP address who completed the action. | 192.168.1.1 |
| {country} | The user's country code | US |
| {status} | Determines whether to add or subtract the amount of the reward. "1" is when the virtual currency should be added to the user and "2" when it should be subtracted. | 1 (valid) / 2 (chargeback) |
| {debug} | Check if it’s a test or a live postback call. | 1 (test) / 0 (live) |
| {signature} | MD5 hash that can be used to verify that the call has been made from our servers. | 17b4e2a70d6efe9796dd4c5507a9f9ab |
POST Method
http://yoururl.com/postback/revlum
On your server, you will read the POST body variable to retrieve macro's value.
| Parameter | Description | Example |
|---|---|---|
| subId | Unique user identifier, passed by publisher. | revlum1 |
| sub1 | Additional subId that can be passed in the tracking link | revlum |
| transId | Use this to prevent double conversions. | REV-351 |
| offerName | Name of the completed offer. | Revlum - Sign up and Earn |
| offerId | Id of the completed offer. | 1354 |
| event_id | Id of the completed offer event (empty if base event). | bhf38ysj18 |
| event_name | Name of the completed offer event (empty if base event). | Reach lvl 1 |
| reward | User reward in app currency | 25.0 |
| reward_name | The name of your in app currency. | Coins |
| payout | Complete payment in USD, paid to the publisher. | 0.10 |
| userIp | The user's IP address who completed the action. | 192.168.1.1 |
| country | The user's country code | US |
| status | Determines whether to add or subtract the amount of the reward. "1" is when the virtual currency should be added to the user and "2" when it should be subtracted. | 1 (valid) / 2 (chargeback) |
| debug | Check if it’s a test or a live postback call. | 1 (test) / 0 (live) |
| signature | MD5 hash that can be used to verify that the call has been made from our servers. | 17b4e2a70d6efe9796dd4c5507a9f9ab |
{reward} and {payout} parameters are always absolute values, you will need to check status parameter to see if you need to add or subtract that amount from your users.
Updated 3 months ago