Skip to main content

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.

​
Offers IFrame Integration Guide

Embed the PrimeEarn Games & Offers wall directly into your app or website using an IFrame or WebView. This guide walks you through the full setup in six steps.

​
Step 1 — Get Your URL

Your dedicated offers/games wall URL is: 
https://monetize.primeearn.com/offers?app=XXXXXXXX&uuid=Test123
Replace XXXXXXXX with your Publisher App ID and Test123 with your user’s unique identifier (see Step 3).
Need the combined wall (Surveys + Games)? Use https://monetize.primeearn.com/featured?app=XXXXXXXX&uuid=Test123 instead.

​
Step 2 — Implement in Your App or Website

Choose the integration method that fits your platform:

​
WebView (Mobile Apps)

Load the URL inside a native WebView component. Make sure the WebView has:
  • JavaScript enabled
  • DOM storage enabled
  • Redirect/navigation handling so external links open in a browser

​
IFrame (Web)

<iframe
  src="https://monetize.primeearn.com/offers?app=XXXXXXXX&uuid=Test123"
  width="100%"
  height="700"
  frameborder="0"
  allow="clipboard-write"
  title="PrimeEarn Offers Wall"
></iframe>

​
New Browser Tab

If an IFrame is not suitable, open the URL in a new tab: 
window.open(
  'https://monetize.primeearn.com/offers?app=XXXXXXXX&uuid=Test123',
  '_blank',
  'noopener,noreferrer'
);

​
Step 3 — Pass Parameters

Replace the uuid placeholder with a unique, stable identifier for the current user. This ties offer completions to the correct account.
ParameterRequiredDescription
appYesYour Publisher App ID (provided in your dashboard)
uuidYesA unique, persistent ID for the end user
maidIf availableMobile Advertising ID — IDFA on iOS or GAID on Android. Must be provided when available; significantly improves performance.
ageNoUser age for offer targeting (0–150).
birthdayNoDate of birth in YYYY-MM-DD format. Preferred over age when both are available.
genderNoUser gender: m (Male) or f (Female).
zipNoPostal / ZIP code for geo-targeted offer matching.
Age vs. birthday: If you have both, prefer passing birthday — it is more precise and provides better targeting than age alone.
Example with a real user ID: 
https://monetize.primeearn.com/offers?app=myApp1234&uuid=user_abc_987
Never reuse uuid values across different users. Each user must have a stable, unique ID to ensure rewards are attributed correctly.

​
Step 4 — Customize Design

The offers wall supports several design parameters you can append to the URL.
ParameterValuesDescription
themelight / darkSets the color scheme
colorHex code (e.g. 3498db)Primary accent color (no #)
logoURL-encoded image URLYour brand logo displayed at top
Example: 
https://monetize.primeearn.com/offers?app=XXXXXXXX&uuid=Test123&theme=dark&color=3498db
Match the theme parameter to your app’s current color mode for a seamless user experience.

​
Step 5 — Handle Rewards via Postback

When a user completes an offer or game milestone, PrimeEarn fires a server-to-server postback to your configured callback URL.

​
Postback URL Format

Configure your callback URL in the dashboard. PrimeEarn will substitute the placeholders at the time of the event: 
https://your-server.com/reward?user={user_id}&amount={reward}&type={type}&tx={tx_id}

​
Postback Parameters

ParameterTypeDescription
{reward}IntegerAmount of in-app currency to award to the user
{payout}Integer/FloatPublisher payout in USD
{type}IntegerEvent type (see table below)
{user}StringThe unique user ID you passed as uuid
{tx_id}StringUnique transaction ID for deduplication

​
Games/Offers Event Types ({type})

ValueEventDescription
7CompletedOffer/game task fully completed and credited
9ReconciledTransaction reconciled after review. tx_id starts with R-
11PendingInitial postback during a Credit Delay 7 offer

​
Understanding Credit Delay 7

Credit Delay 7 ExplainedSome game offers operate on a 7-day credit delay:
  1. Immediately when the user completes the task, you receive a PENDING postback (type=11).
  2. After 7 days, one of the following is sent:
    • COMPLETED (type=7) — task was verified and credit is confirmed.
    • RECONCILED (type=9) — transaction was reconciled. The tx_id for reconciled events will begin with R-.
Do not grant the reward to the user until you receive the COMPLETED (type=7) or RECONCILED (type=9) postback.

​
Whitelisting IPs

Ensure your server accepts postback requests from these PrimeEarn IPs: 
168.119.57.82
49.12.33.196
49.13.14.251
Reject any postback requests that do not originate from these IPs to prevent reward fraud.

​
Step 6 — Go Live

Before enabling for all users, run through this checklist:
  • Replace XXXXXXXX with your real Publisher App ID
  • Replace Test123 / uuid with your real user ID logic
  • Configure your postback URL in the PrimeEarn dashboard
  • Whitelist the PrimeEarn IP addresses on your server
  • Test a full offer completion in a staging environment and verify your postback receives the correct parameters
  • Handle PENDING (type=11) postbacks without immediately granting rewards
  • Verify deduplication logic using {tx_id}, noting R- prefix for reconciled events
Once all checks pass, deploy and start earning!