Skip to content
ClixWall

Developers

Offerwall integration guide

Embed the ClixWall offerwall in your website or app, then credit your users automatically with postbacks.

To integrate the offerwall, you need a publisher API key, a stable user ID for each person opening the Wall, and a postback URL on your server. Embed the Wall, then send a test conversion before launch.

New to offerwalls? Learn how they work, or see ClixWall for publishers.

  • Websites
  • React Native
  • Expo
  • Flutter
  • Android
  • iOS

Offerwall

Add the ClixWall offerwall to your website or app and give each user a stable ID.

Quick start

Four steps from sign up to your first credited conversion.

  1. Add your website

    Create a publisher account, then add your site or app under Websites. Each website gets its own API key.

  2. Embed the Wall

    Load the Wall URL in an iframe or WebView with your API key and the signed in user's ID.

  3. Set your postback URL

    We call it for every conversion and reversal so your server can credit the user.

  4. Send a test postback

    Open the website, then Settings, then Test, and check that your server credits the sample.

The Wall URL

Every integration loads the same URL. It identifies your website and the user who is earning.

URL
https://clixwall.com/wall?api=YOUR_API_KEY&user=USER_ID
apiRequired
Your website's API key, from the website page.
userRequired
Your user's unique ID, URL encoded.
themeOptional
Color theme: light or dark.

Embed the Wall

Pick your platform. Every sample loads the Wall URL above.

Embed the Wall in any page with an iframe. Replace USER_ID with your signed in user's ID, URL encoded.

HTML
<iframe
src="https://clixwall.com/wall?api=YOUR_API_KEY&user=USER_ID"
title="ClixWall offers"
width="100%"
height="600"
frameborder="0"
allow="clipboard-write"
></iframe>

Security and user IDs

Use a stable, opaque user ID issued by your backend. Never put postback secrets in your app, and validate and credit conversions on your server. Replace YOUR_API_KEY with the key from your website page.

Postback

A postback is a server to server call. When a user completes an offer or task, ClixWall calls your URL so you can credit them automatically.

URL format

URL
https://yoursite.com/postback?user_id={user_id}&secret={secret}&user_payout={user_payout}&user_payout_usd={user_payout_usd}&publisher_payout={publisher_payout}&offer_id={offer_id}&offer_name={offer_name}&transaction_id={transaction_id}&status={status}

Use these readable variables anywhere in your URL. If the URL has no query parameters, ClixWall keeps sending the default fields: u, c, user_payout_usd, payout, cid and the other standard fields.

Use secret={secret} to receive the postback secret under the secret parameter. If you do not specify it in the URL, ClixWall sends it as pwd.

Variables

{user_id}
Your user's identifierDefault field: u
{secret}
Your website's postback secret. If omitted from your URL, it is sent as `pwd`.Default field: pwd
{user_payout}
User credit in your in-app currency (USD until you set a currency value)Default field: c
{user_payout_usd}
User's share in USD, before conversion to your in-app currencyDefault field: user_payout_usd
{publisher_payout}
Your payout in USDDefault field: payout
{offer_id}
Offer or task IDDefault field: cid
{offer_name}
Offer or task nameDefault field: cname
{transaction_id}
Unique conversion IDDefault field: transaction_id
{status}
Credit or reversal statusDefault field: s

Test before you go live

Open your website in ClixWall, then Settings, then Test. We send a sample conversion to your postback URL and show the status code your server answered with.

If the test does not credit your user

If no request arrives, check that your HTTPS URL is public and your handler accepts a form-encoded POST. If the request arrives but the balance stays the same, compare the user ID, user payout, transaction ID and status with your server log. A successful HTTP response alone does not prove the reward was credited. Read more about how postback URLs work.

Offers API

Build your own offer list by fetching available offers from your server.

Base URL

URL
https://api.clixwall.com/v1

Authentication

Use your active publisher API key as a Bearer token. Keep it on your server; do not put it in browser or app code.

HTTP
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Get available offers

Shell
curl "https://api.clixwall.com/v1/offers?country=US&user_id=user_123" \
-H "Authorization: Bearer YOUR_PUBLISHER_API_KEY"

Response:

JSON
{
"success": true,
"data": [
{
"id": 123,
"name": "Complete Survey",
"description": "Complete a short survey",
"payout": 0.5,
"currency": "$",
"category": "Surveys",
"click_url": "https://api.clixwall.com/v1/clicks"
}
]
}

Need help?

Stuck on an integration step? Our team can check your setup with you.

Contact support