Integrate the FarLox offerwall into your application with secure offerwall URLs, iframe embeds, real-time postback tracking, and a clean conversion API built for performance marketers.
Use the following URL format to integrate the FarLox offerwall into your website or mobile application. Both parameters are required.
https://farlox.com/offerwall.php?placement_id=YOUR_PLACEMRNT&user_id=USER_123
| Parameter | Description | Example |
|---|---|---|
placement_id | Your placement ID | 12 |
user_id | Your unique user identifier | USER_123 |
Embed the FarLox offerwall inside your platform using a standard iframe integration. The frame is fully responsive.
<iframe src="https://farlox.com/offerwall.php?placement_id=YOUR_PLACEMRNT&user_id=USER_123" width="100%" height="800" frameborder="0" ></iframe>
| Option | Description |
|---|---|
width="100%" | Responsive full width |
height="800" | Offerwall frame height |
border:none | Removes iframe border |
Use these macros in your Postback URL to receive conversion data in real time. FarLox replaces each macro with the corresponding value at fire time.
https://yourwebsite.com/postback.php?subId={subId}&transId={transId}&reward={reward}&payout={payout}&signature={signature}&status={status}&offer_id={offer_id}&offer_name={offer_name}&round_reward={round_reward}&userIp={userIp}&country={country}&uuid={uuid}&event_id={event_id}&event_name={event_name}
| Parameter | Type | Description |
|---|---|---|
subId | string | Your user's unique identifier (the one you passed as USER_ID). |
transId | string | Unique transaction ID — use for deduplication. |
reward | number | Amount of virtual currency to credit. |
payout | number | Offer payout in USD. |
signature | string | MD5 hash for verification (see below). |
status | integer | 1 = credit · 2 = chargeback (subtract). |
offer_id | string | Completed offer ID. |
offer_name | string | Completed offer name. |
round_reward | number | Reward rounded to your site's decimal setting. |
userIp | string | User's IP address. |
country | string | ISO 2-letter country code. |
uuid | string | Unique click ID. |
event_id | string | Event ID (multi-reward offers only). |
event_name | string | Event name (multi-reward offers only). |
Always verify the signature before applying the reward or chargeback. This protects your endpoint from spoofed requests. The formula is:
md5(subId + transId + reward + SECRET_KEY)
Example PHP implementation that verifies the signature, deduplicates by transId, then credits or debits the user based on status.
<?php // Verify a FarLox postback before crediting the user $expected = md5($_GET['subId'] . $_GET['transId'] . $_GET['reward'] . SECRET_KEY); if (!hash_equals($expected, $_GET['signature'])) { http_response_code(403); exit('Invalid signature'); } // Deduplicate by transId if (transactionExists($_GET['transId'])) { exit('OK'); // already handled } if ($_GET['status'] == 1) { creditUser($_GET['subId'], $_GET['reward']); } elseif ($_GET['status'] == 2) { debitUser($_GET['subId'], $_GET['reward']); // chargeback } echo 'OK';
OK) once handled.Example JSON responses your server should return after processing a postback request.
{ "success": true, "message": "Reward added successfully" }
{ "success": false, "message": "Duplicate transaction" }
Follow these recommendations to keep your integration secure, reliable, and ready for production traffic.