# Postback Parameters

Whenever a user complete an offer, we will make a call to the Postback URL that you indicated in your placement attaching all the information that you will need to credit your users.

In case of GET method, you need to wrap parameters into curly brackets `{}` , we will replace your parameters which the appropriate value.

In case of POST method, you just need to pass your endpoint, and we will send all the data via POST request to your server we use `multipart/form-data` format. For example you can access subId by `$_POST['subId']` in PHP.

**GET URL Example:** `https://example.com/callbacks/revtoo.php?subId={subId}&transId={transId}&payout={payout}&reward={reward}&status={status}&userIp={userIp}&offer_name={offer_name}&debug={debug}&signature={signature}` 

**POST URL Example:** `https://example.com/callbacks/revtoo.php` 

### Our Supported Parameters

| Parameter         | Description                                                                                                                                                                                                                                                                                                                                                          | Example                                                           |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| **subId**         | This is the unique identifier code of the user who completed action on your platform.                                                                                                                                                                                                                                                                                | user123                                                           |
| **transId**       | Unique identification code of the transaction made by your user.                                                                                                                                                                                                                                                                                                     | REV-12345678                                                      |
| **offer\_id**     | ID of the completed offer.                                                                                                                                                                                                                                                                                                                                           | 123, 321, and 0 (for postback test only)                          |
| **offer\_name**   | Name of the completed offer.                                                                                                                                                                                                                                                                                                                                         | Monopoly GO!                                                      |
| **offer\_type**   | Type of the offer completed by user (offer, survey, video, ptc, etc).                                                                                                                                                                                                                                                                                                | offer                                                             |
| **reward**        | Amount of your virtual currency to be credited to your user.                                                                                                                                                                                                                                                                                                         | 500                                                               |
| **reward\_name**  | The name of your currency set when you registered your website.                                                                                                                                                                                                                                                                                                      | Points                                                            |
| **payout**        | The offer payout in USD                                                                                                                                                                                                                                                                                                                                              | 1.00                                                              |
| **userIp**        | The user's IP address who completed the action.                                                                                                                                                                                                                                                                                                                      | 192.168.1.0                                                       |
| **country**       | Country (ISO2 form) from the lead comes.                                                                                                                                                                                                                                                                                                                             | 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. 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. | 1 (Credit) / 2 (Chargeback)                                       |
| **debug**         | Check if is 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\_value** | Amount of your virtual currency credited for $1 worth of payout (Exchange Rate). Its always static.                                                                                                                                                                                                                                                                  | Your Currency Exchange Rate (e.g. 50, 500, 2500, 5000 per dollar) |

{% hint style="info" %}
**"reward"** and **"payout"** parameters are always positive values, you will need to check status and transId parameter to see if you need to add or subtract that amount from your users.
{% endhint %}

{% hint style="info" %}
Keep in mind that **reward\_value** shows the currency exchange rate you set for your placement. For example, if you set the currency exchange to 500, **reward\_value** will always be 500. It doesn’t depend on the payout or any calculation—it’s just the exchange rate you set.\
\ <mark style="color:red;">To reward your users, use the</mark> <mark style="color:red;"></mark><mark style="color:red;">**reward**</mark> <mark style="color:red;"></mark><mark style="color:red;">parameter.</mark>&#x20;
{% endhint %}