---
updatedAt: 2025-05-14T22:26:45.000Z
agentTools:
  projectIndex: https://developer.revlum.com/llms.txt
---

# 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                           |
| \{sub2}         | Additional subId that can be passed in the tracking link                                                                                                           | revlum1                          |
| \{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                           |
| sub2         | Additional subId that can be passed in the tracking link                                                                                                           | revlum1                          |
| 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.