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)

bat
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:

  1. Placement is Live
  2. Postback URL is saved on the placement (not only in Reports)
  3. api_key matches; Authorization: Bearer sk_... (or secret_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