Postback URL Configuration: Complete Setup Guide for Offerwall Publishers
What is a Postback URL?
A postback URL is the endpoint on your server that receives conversion data from the monetization platform. When a user completes an offer, the platform sends an HTTP request to your postback URL with the conversion details. You configure this URL in the Perkox Publisher Dashboard under Apps → Postback URL Configuration. The platform replaces placeholders with real values at runtime.
Step-by-Step Configuration
1. Create a publicly accessible endpoint on your server
2. In the dashboard, enter your URL with placeholders
3. Test with a sample offer
4. Verify the data arrives correctly
5. Go live
Placeholder Reference
| Placeholder | Value | Example |
|---|---|---|
| {player_id} | User ID from SDK | player123 |
| {click_id} | Unique click ID | d4246e2ca2894efc |
| {offer_id} | Completed offer | 10101 |
| {reward_amount} | User reward | 50.00 |
| {payout} | Publisher payout | 10.00 |
| {status} | Conversion status | approved |
Reward Status Handling
| Status | Meaning | Action |
|---|---|---|
| pending | Under review | Wait |
| approved | Validated | Credit user |
| rejected | Not approved | Ignore |
| reversed | Previously approved, now reversed | Remove credit |
GET vs POST
GET: Parameters in URL query string. Simpler, easier to debug. Recommended for most integrations.
POST: Parameters in request body. Use for advanced backends that require structured data.
Testing Checklist
☐ Postback endpoint returns HTTP 200
☐ All placeholders replaced with real values
☐ Duplicate click_id is blocked
☐ Approved status credits user
☐ Rejected status does not credit
☐ Reversed status removes credit