Postback Integration
Postback Keys
Postback keys authenticate incoming conversion notifications. You need at least one key before receiving postbacks. You can have up to 5 keys.
Managing Keys
- Go to Postback Keys in the admin panel.
- Click "Generate Key" to create a new key.
- Copy the key or the full postback URL using the copy icons.
- Delete unused keys with the trash icon.
Key Rotation
If a key is compromised, delete it and generate a new one. Update the postback URL at your advertiser/network with the new key. Use different keys for different networks to isolate access.
Postback URL & Parameters
A postback is an HTTP request sent by the advertiser when a conversion happens. It tells TraffSure which click converted and optionally what goal was achieved.
Postback URL Format
https://yourdomain.com/postback/{key}?click={click_hash}[&goal={goal_key}]
Required Parameters
| Parameter | Description | Example |
|---|---|---|
| click | The click hash passed to your landing page via {click} macro |
a1b2c3d4e5f6... |
Optional Parameters
| Parameter | Description | Default |
|---|---|---|
| goal | Goal key from your flow. If omitted, conversion goes to the Other bucket. |
— |
| status | Conversion status: approved, pending, or rejected |
pending |
| revenue / price | Conversion payout amount (overrides goal default) | Goal revenue |
| currency | Revenue currency code | USD |
| uid | External user/transaction identifier from the advertiser | — |
Example Postback
GET https://yourdomain.com/postback/abc123...?click=d4e5f6...&goal=registration&status=approved&revenue=2.50&uid=user_789
Response Codes
- 200 — Conversion recorded successfully.
- 404 — Click or flow not found.
- 422 — Validation error (for example, missing
click).
Previous: Click Tracking & Macros · Next: Monitoring & Reports