Documentation Index
Fetch the complete documentation index at: https://docs.primeearn.com/llms.txt
Use this file to discover all available pages before exploring further.
Rewards & Postback Setup
This guide covers two things: how to configure currency and reward display in your app, and how PrimeEarn sends postback notifications to your server when users complete surveys, games, or offers.
Currency & Reward Setup
You can configure how rewards are displayed in your app separately for surveys, screenouts, and games/offers.
| Setting | Description |
|---|
| Currency Name | Name of your in-app currency (e.g. Coins, Diamonds, Credits). |
| Currency Exchange Rate | How much in-app currency users receive per 1youearn.Example:ifsetto‘100‘,usersreceive100pointsper1. |
| Currency Exchange Rate (Screenout Rewards) | Conversion rate specifically for users who screen out of a survey. Example: if set to 10, users get 10 points per $1 screenout reward value. |
| Currency Exchange Rate (Games/Offers) | Conversion rate for games & offers rewards. |
| Move Decimal Point | Adjusts how reward amounts are displayed to users. |
Move Decimal Point Examples
| Setting | Display |
|---|
| No decimal | 100 points |
| 1 decimal | 10.0 points |
| 2 decimals | 1.00 points |
| 3 decimals | 0.100 points |
The reward amount is always rounded to a full number. Set a minimum value of 10 to avoid rounding issues.
Postback Setup — Surveys
When a user completes a survey action, PrimeEarn sends a server-to-server postback to your configured callback URL.
Postback Parameters
| Parameter | Type | Description |
|---|
{reward} | Integer | Amount of in-app currency to reward to the user. |
{payout} | Integer | Publisher payout in USD. |
{type} | Integer | Event type: 1 = complete, 2 = screenout, 3 = bonus, 4 = reconciliation. |
{user} | String | Unique user ID. |
{tx_id} | String | Unique transaction ID. Process each {tx_id} only once. |
{subid} | String | Custom subid returned back to you. |
All postback types are essential for accurate reward distribution, including type = 3. Ensure your system is configured to handle this type.
When is type = 3 used?
- Manual reward distribution — when a user is not rewarded due to an error or technical issue, we send a manual postback (
type=3) to ensure they receive their reward.
- Challenge-based promotions — for users who complete promotional challenges. This is only available for the Surveys IFrame Integration.
- Pre-qualification rewards — for users who successfully complete pre-qualification questions.
Postback Setup — Games & Offers
Postback Parameters
| Parameter | Type | Description |
|---|
{user} | String | Unique user ID. |
{tx_id} | String | Unique transaction ID. Process each {tx_id} only once. |
{type} | Integer | Event type: 7 = completed, 9 = reconciled, 11 = pending. |
{payout} | Float | Publisher payout in USD. |
{platform} | String | Platform where the event occurred (mobile, tablet, desktop). |
{offer_name} | String | Display name of the offer. |
{offer_hash} | String | Unique identifier/hash for the offer. |
{task_name} | String | Specific task or milestone completed in the offer. |
{task_id} | String | Unique identifier for the task. |
{ip_address} | String | User’s IP address (IPv4 only). |
{user_reward_money_value} | Float | Monetary value of the reward before currency conversion. |
{user_currency} | String | User reward currency (e.g. USD, EUR). |
{reward} | Integer | In-app currency rewarded to the user. |
Make sure you only process each {tx_id} once.
Credit Delay 7 — Pending Rewards
Credit Delay 7 applies to games & offers only.
Step 1 — Pending postback (immediate)
When the user completes a task, you immediately receive a PENDING postback:
https://publisher.com/postback?
user=user_abc123&
tx_id=tx_xyz789&
type=11&
status=PENDING&
credit_delay=7
Step 2 — Final postback (after 7 days)
After verification, you receive one of two outcomes:
COMPLETED (type=7)
RECONCILED (type=9)
User is verified as legitimate. Credit the reward now.https://publisher.com/postback?
user=user_abc123&
tx_id=tx_xyz789&
type=7&
status=COMPLETED
Fraud detected. Do not credit the user.https://publisher.com/unpaid-postback?
user=user_abc123&
tx_id=R-tx_xyz789&
type=9&
status=RECONCILED
Reconciled postbacks include an R- prefix in the tx_id.
Reconciliation & Webhooks
| Setting | Default | Description |
|---|
| Resend failed webhooks | Enabled | Failed postbacks are automatically retried. |
| Reconciliation webhooks | — | Triggered with negative values when a completion is rejected. |
IP Whitelist
Ensure your server accepts postback requests from these PrimeEarn IP addresses only. Reject all other sources to prevent reward fraud.
168.119.57.82
49.12.33.196
49.13.14.251