Learn how BucksWall's server-to-server postback system works, so you can automatically credit your users the moment they complete an offer.
A postback (also known as a server-to-server or S2S callback) is a URL request we send to your server the moment a conversion is recorded and approved on our network. This lets you automatically update your users' balances, track performance, and manage your system without any manual checks.
Once you're signed up, you'll set your own Postback URL on your Placements page for your offerwall, or on the Postback page for individual offer promotions — both inside your publisher dashboard.
Use these macros in your Postback URL. We'll replace each one with the real data for every conversion.
| Macro | Description |
|---|---|
| {subid1} | The User ID you passed in your tracking link (e.g. from your subid1 or user_id parameter). |
| {payout} | The payout amount for the conversion, in USD (e.g. 0.75). |
| {currency_amount} | The calculated virtual currency amount based on your placement's exchange rate (e.g. 75). |
| {currency_name} | The name of your virtual currency (e.g. "Coins"). |
| {offer_name} | The name of the offer that was completed. |
| {ip_address} | The user's IP address at the time of the original click. |
| {status} | The status of the conversion (e.g. "approved"). |
| {subid2} | The value passed in your SubID 2 parameter. For offerwall conversions, this is your Placement ID. |
Say you want to award a user on your gaming website whose ID on your platform is user123. You'd give them an offerwall link like this:
On your Placements page, you'd set your Postback URL like this:
When the user completes an offer, we'll call that URL with the macros replaced — resulting in a real request to your server like this:
Create a publisher account to get your own unique postback URL and start tracking conversions in minutes.
Get Started Free