Publisher Documentation

Everything you need to add the Voen direct offerwall to your app or website, reward your users and receive postbacks when they complete offers.

1. Getting started
2. Add your app
3. Offerwall integration
4. Postback
5. Testing
6. Payments

1. Getting started

Create a publisher account and verify your email address.
Our team reviews every new account. While it is under review you will see an Account Pending page.
Once approved, log in to open your dashboard.

2. Add your app or website

Go to Apps in your dashboard and create a new placement:

Platform – where the offerwall will be shown (Web/Desktop, Android or iOS).
Property name & URL – your app or website name and its public link.
Traffic description – a short summary of your audience across countries and devices.
Points rate – how many of your in-app currency units a user receives per 1 USD of payout.
Postback URL – the address on your server we call when a user earns a reward (see Postback).

After saving, your placement gets an App ID and an API key.

3. Offerwall integration

Show the offerwall by loading this URL, replacing {app_id} with your App ID and {user_id} with the unique ID of the signed-in user:

https://voendirect.com/app/iframe/{app_id}/{user_id}

On a website, embed it as a full-screen iframe:

<iframe src="https://voendirect.com/app/iframe/{app_id}/{user_id}"
        style="position:fixed; top:0; left:0; bottom:0; right:0; width:100%; height:100%; border:none; margin:0; padding:0; overflow:hidden; z-index:999999;"></iframe>

In a mobile app, open the same URL in a WebView or in-app browser. The {user_id} must never be empty or 0 – it is sent back to you in the postback so you know which user to reward. Your ready-made code is also shown on the Offerwall & Postback Test tab of each app.

4. Postback

When a user completes an offer, Voen direct sends an HTTP request to your postback URL. Add any of the variables below to your URL and they will be replaced with real values:

https://your-domain.com/postback?user_id={user_id}&reward={reward}&payout={payout}&status={status}&offer={offerName}&ip={user_ip}&country={country}&debug={debug}

Parameter	Description	Example
`{user_id}`	The ID of your user, as placed in the offerwall URL.	user1
`{reward}`	User reward in your app currency, based on your points rate.	500
`{payout}`	Payout in USD earned by you, the publisher.	0.01
`{status}`	`1` = add the reward to the user, `2` = chargeback, subtract it.	1 / 2
`{offerName}`	Name of the completed offer.	Voen direct - Sign up and Earn
`{user_ip}`	IP address of the user when the click happened.	192.168.1.1
`{country}`	Country of the user as an ISO 3166-1 alpha-2 code.	US
`{debug}`	`1` = test postback, `0` = live postback.	1 / 0

Handling postbacks on your server

Respond with HTTP 200 once the request has been processed.
When status is 1, credit reward to user_id; when it is 2, deduct it.
Ignore or log requests where debug is 1 so test calls do not credit real users.
Keep a log of processed postbacks to avoid crediting the same conversion twice.

5. Testing

Open your app in the dashboard and go to the Offerwall & Postback Test tab. Enter a user ID and payout, choose Valid or Chargeback and click Test Postback. The response from your server is shown on the page, and every call is listed under Postback Reports.

6. Payments

Add your payout details under Payment Details in your dashboard. Earnings appear in Transactions, and payouts are listed under Withdrawals once you reach the minimum payment threshold.