Help centre / Rewards and postbacks
How your server is told about rewards
We call an address on your server for every completion, screen-out and reversal. That call is how your users get paid.
When a user earns a reward we call an address on your server. That call is named a postback. Your server checks that it really comes from us and adds the reward to the user's balance.
Setting it up
- Open the app's settings and enter your postback URL.
- Place the values you want in the address, such as the user, the reward and the signature.
- On the app page under Postbacks, send a test completion and a test reversal.
The three messages
- Completed: the user finished a survey. Add the reward.
- Screen-out: the user did not qualify. Usually there is nothing to add.
- Reversed: an earlier completion was taken back. Deduct it. The amount arrives negative.
Three rules for your server
- Check the signature and refuse anything that does not match.
- Handle each reward once, even if the same message arrives twice.
- Do not credit real balances for messages marked as a test.
The exact values, the signature and sample code are in Postbacks.