Configure app-specific postback URLs to receive conversion notifications.
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.
https://your-domain.com/postback?user={user_id}&txn={transaction_id}&amount={payout}&reward={reward}&status={status}
| Macro | Description | Example |
|---|---|---|
{user_id} |
Your end-user ID passed to the offerwall | USER123 |
{transaction_id} |
Unique transaction ID — use it for anti-dupe. On chargeback it ends with -CB |
n2:abc|evt:99 |
{payout} |
Your payout in USD (negative on chargeback) | 0.50 |
{reward} |
End-user reward in your points/currency (negative on chargeback) | 250 |
{status} |
Conversion status — see Status values below | approved / chargedback |
{click_id} |
Click tracking ID | clk_abc123 |
{offer_id} |
Completed offer ID | 12345 |
{offer_name} |
Offer name (URL-encoded) | Complete%20Survey |
{website_id} |
Your app / placement ID | 15 |
{currency} |
App currency code | COIN |
{ip} |
User IP address | 192.168.1.1 |
{country} |
User country code | US |
{device} |
User device type | android |
{timestamp} |
Unix timestamp when the postback is sent | 1705789234 |
{aff_sub} … {aff_sub4} |
Custom sub IDs 1–4 | campaign1 |
Chargebacks are handled automatically on our side: the amount is deducted from your Wallunex balance as soon as the network reverses the conversion (your balance can go negative if it was already paid out). You do not need to report anything to us.
We then send you a chargeback postback so you can remove the reward from your user:
{status} = chargedback{payout} and {reward} are negative{transaction_id} is new (original ID + -CB), so your anti-dupe accepts it instead of flagging a duplicateSimplest handling: add the amount as received (it is already negative). If your code subtracts on chargeback, subtract the absolute value — never subtract a negative number.
Always read {status} on every postback. Credit the user only on
approved.
| Status | Meaning | What you should do |
|---|---|---|
approved |
Conversion accepted — credit the user | Add the reward once (dedupe by transaction_id) |
chargedback |
Network / admin reversed the conversion | Remove the reward from the user (amount is negative) |
rejected / reversed |
Same as chargeback | Treat exactly like chargedback |
?txn=n2:abc|evt:99&amount=0.50&reward=250&status=approved?txn=n2:abc|evt:99-CB&amount=-0.50&reward=-250&status=chargedback
— remove 250 points from the user.
OK)Use the Test Postback button on your app page to send a sample conversion.