Integration guide
Test postback
Fire a safe test callback to your placement postback URL.
Test postback
GET /api/v1/postback/test sends a signed GET to the postback URL saved on the placement (Integrate / edit placement).
It does not call URLs under Publisher → Reports → Postbacks. Use Reports postbacks for live rewards.
Dry run (shows final URL, does not call your server)
curl -H "Authorization: Bearer sk_YOUR_SECRET" "https://prismads.co/api/v1/postback/test?placement_id=YOUR_ID&api_key=pk_YOUR_KEY&user_id=test_user_1&dry_run=1"Live fire
Remove dry_run=1. We GET the placement postback URL with filled macros. Signature uses the placement secret key.
Requirements:
- Placement is Live
- Postback URL is saved on the placement (not only in Reports)
api_keymatches;Authorization: Bearer sk_...(orsecret_key) required to sign
Optional query: payout, value, offer_id, country, status
Errors
| HTTP | Code | Meaning |
|---|---|---|
| 400 | POSTBACK_NOT_CONFIGURED |
No postback URL on the placement |
| 401 | SECRET_KEY_REQUIRED |
Missing Bearer / secret key |