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

ParameterMeaning
user_idYour own user ID, passed through the offerwall and returned unchanged.
offer_idThe offer that was completed.
payoutPayout for this conversion.
txn_idUnique transaction ID. Use it to prevent duplicate credits.
statusConversion status, including reversals where applicable.

Best practice

  • Store txn_id and 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.