Developer Resources
Postback Guide
How server-to-server postbacks work, the common parameters, and how to test and secure your integration.
How a postback works
When a user completes an offer, LeadXWall calls the URL you configured with the conversion details so you can credit the user in real time.
https://yourdomain.com/postback
?user_id={user_id}
&offer_id={offer_id}
&payout={payout}
&txn_id={transaction_id}
&status={status}Example only. Copy the exact URL and macros from your dashboard after approval.
Common parameters
| Parameter | Meaning |
|---|---|
user_id | Your own user ID, passed through the offerwall and returned unchanged. |
offer_id | The offer that was completed. |
payout | Payout for this conversion. |
txn_id | Unique transaction ID. Use it to prevent duplicate credits. |
status | Conversion status, including reversals where applicable. |
Best practice
- Store
txn_idand ignore any repeat of the same ID. - Respond with HTTP 200 once the conversion is recorded.
- Allow our servers to reach your endpoint and keep it on HTTPS.
- Handle reversals so rejected conversions are removed from user balances.
- Test with a sample conversion before sending live traffic.
