Offerwall
HTML (iframe version)
API
Accessing the API API Parameters API Response
Postbacks
Reward Apps

Reward Apps Postback

Configure app-specific postback URLs to receive conversion notifications.

Overview

App-level postbacks allow you to set a unique postback URL for each of your apps or websites. When a user completes an offer, we send a server-to-server GET request to your URL with conversion details.

Configuration

  1. Go to your Publisher Dashboard
  2. Open your app and edit settings
  3. Enter your Postback URL
  4. Save changes

Postback URL Format

https://your-domain.com/postback?user={user_id}&txn={transaction_id}&amount={payout}&reward={payout_local}¤cy={currency}&status={status}

Available Macros

Macro Description Example
{user_id} Your end-user ID passed to the offerwall USER123
{website_id} Your app / placement ID 15
{website_name} Your app / placement name MyApp
{click_id} Internal click tracking ID clk_abc123
{subid} Alias of {click_id} clk_abc123
{transaction_id} Full ledger TRX for anti-dupe (stable on chargeback) n2:abc|evt:99
{network_transaction_id} Alias of {transaction_id} n2:abc|evt:99
{short_transaction_id} Compact ID (optional) CM12345
{offer_id} Completed offer ID 12345
{offer_name} Offer name (URL-encoded) Complete%20Survey
{payout} Publisher payout in USD 0.50
{payout_local} End-user reward in your local points/currency 250
{reward} Alias of {payout_local} 250
{currency} App currency code COIN
{ip} User IP address 192.168.1.1
{country} User country code US
{device} User device type android
{status} Conversion status approved
{timestamp} Unix timestamp when the postback is sent 1705789234
{aff_sub} Custom sub ID 1 campaign1
{aff_sub2} Custom sub ID 2 source_a
{aff_sub3} Custom sub ID 3 -
{aff_sub4} Custom sub ID 4 -

Example

https://example.com/postback?uid={user_id}&txn={transaction_id}&amount={payout}&points={payout_local}&status={status}

Response

Testing

Use the Test Postback button on your app page to send a sample conversion.