Developer Documentation
Revlunix Integration Docs
Integrate the Revlunix offerwall into your application using our secure offerwall URLs, iframe integrations, and postback tracking system.
Offerwall Integration
Use the following URL format to integrate the Revlunix offerwall into your website or mobile application.
https://revlunix.com/offerwall.php?placement_id=12&user_id=USER_123
| Parameter | Description | Example |
|---|---|---|
| placement_id | Your placement ID | 12 |
| user_id | Your unique user identifier | USER_123 |
Iframe Integration
Embed the Revlunix offerwall inside your platform using iframe integration.
<iframe
src="https://revlunix.com/offerwall.php?placement_id=12&user_id=USER_123"
width="100%"
height="800"
frameborder="0"
style="border:none;border-radius:16px;">
</iframe>
| Option | Description |
|---|---|
| width="100%" | Responsive full width |
| height="800" | Offerwall frame height |
| border:none | Removes iframe border |
Postback Setup Guide
Use these macros in your Postback URL to receive conversion data in real time.
https://yourwebsite.com/postback.php?user_id={subid1}&offer_name={offer_name}&payout={payout}&reward={currency_amount}&transaction_id={transactionId}&status={status}&ip={ip_address}
| Macro | Description | Example Value |
|---|---|---|
| {subid1} | Your User ID | USER_123 |
| {offer_name} | The completed offer name | Coin Master |
| {payout} | Payout amount in USD | 0.75 |
| {currency_amount} | Reward amount | 75 |
| {transactionId} | Unique conversion ID | TXN_93822 |
| {status} | Conversion status | approved |
| {ip_address} | User IP address | 192.168.0.1 |
Response Examples
Example JSON responses from your server after receiving a postback.
{
"success": true,
"message": "Reward added successfully"
}
{
"success": false,
"message": "Duplicate transaction"
}
Best Practices
Recommended Integration Tips
- Always validate postbacks server-side
- Prevent duplicate transaction IDs
- Use HTTPS only
- Store conversion logs
- Validate payout amounts
- Avoid iframe inside iframe
- Use responsive layouts for mobile users