Documentation

Android Integration

If you are looking to integrate the offerwall into your Android app, either open the offerwall in Google Chrome or use a web view to show the offerwall inside your app.

URL

https://ewall.biz/offerwall/[API_KEY]/[USER_ID]

WebView Example

WebView myWebView = new WebView(activityContext);
setContentView(myWebView);

WebSettings webSettings = myWebView.getSettings();
webSettings.setJavaScriptEnabled(true);

myWebView.loadUrl("https://ewall.biz/offerwall/[API_KEY]/[USER_ID]");

Replace [API_KEY] with your website api key and [USER_ID] by the unique identifier code of the user of your site who is viewing the wall.

iOS Integration

If you are looking to integrate the offerwall into your iOS app, either open the offerwall in Safari or use a web view to show the offerwall inside your app.

URL

https://ewall.biz/offerwall/[API_KEY]/[USER_ID]

WebView Example

import UIKit
import WebKit
class ViewController: UIViewController, WKUIDelegate {

   var webView: WKWebView!

   override func loadView() {
       let webConfiguration = WKWebViewConfiguration()
       webView = WKWebView(frame: .zero, configuration: webConfiguration)
       webView.uiDelegate = self
       view = webView
   }
   override func viewDidLoad() {
       super.viewDidLoad()
       let myURL = URL(string:"https://ewall.biz/offerwall/[API_KEY]/[USER_ID]")
       let myRequest = URLRequest(url: myURL!)
       webView.load(myRequest)
   }}

Replace [API_KEY] with your website api key and [USER_ID] by the unique identifier code of the user of your site who is viewing the wall.

React Native

If you are looking to integrate the offerwall into your React Native app, either open the offerwall in the default browser of the user with the Linking-API or use react-native-webview to show the offerwall inside your app.

Linking

import { Linking } from 'react-native';
Linking.openURL('https://ewall.biz/offerwall/[API_KEY]/[USER_ID]');

React Native WebView

/*
  Add react-native-webview to your dependencies. Using Yarn:
	yarn add react-native-webview
  Using npm:
	npm install --save react-native-webview
  Using Expo:
	npx expo install react-native-webview
*/
import { WebView } from 'react-native-webview';
return <WebView source={{ uri: 'https://ewall.biz/offerwall/[API_KEY]/[USER_ID]' }} />;

Replace [API_KEY] with your website api key and [USER_ID] by the unique identifier code of the user of your site who is viewing the wall.

Offerwall Parameters

Bellow you can see parameters supported by our offerwall. Make sure you properly replace them during your offerwall integration.

Postback Notifications

Whenever a user complete an offer, we will make a call to the Postback URL that you indicated in your app attaching all the information that you will need to credit your users.

Our server will make a HTTP POST request to your server including all of the following parameters.

"reward" and "payout" parameters are always absolute values, you will need to check status parameter to see if you need to add or subtract that amount from your users.

Postback Security

You should verify the signature received in the postback to ensure that the call comes from our servers.
Signature parameter should match MD5 of subId transactionId reward secret key. You can find your Secret Key of your website in My Websites section.

The formula to be checked is as follows:

<?php
  $secret = ""; // Get your secret key from Ewall

  $subId = isset($_REQUEST['subId']) ? $_REQUEST['subId'] : null;
  $transId = isset($_REQUEST['transId']) ? $_REQUEST['transId'] : null;
  $reward = isset($_REQUEST['reward']) ? $_REQUEST['reward'] : null;
  $signature = isset($_REQUEST['signature']) ? $_REQUEST['signature'] : null;

  // Validate Signature
  if(md5($subId.$transId.$reward.$secret) != $signature)
  {
   echo "ERROR: Signature doesn't match";
   return;
  }
?>

Our servers wait for a response for a maximum time of 60 seconds before the timeout. In this case, postback will be marked as failed. Please, check if the transaction ID sent to you was already entered in your database, this will prevent to give twice the same amount of virtual currency to the user.

Respond to Postback

Our servers will expect your website to respond with "ok". If your postback doesn't return "ok" as response, postback will be marked as failed (even if postback was successfully called) and you will be able to resend it manually from our website.

Postback Example

The following PHP example is not a working one but should be enough to understand how you should implement your postback in your website.

<?php
  $secret = ""; // Get your secret key from Ewall

  // Proceess only requests from Ewall IP addresses
  $allowed_ips = array('23.95.130.144','173.249.37.16','107.173.28.51');
  if(isset($_SERVER['HTTP_X_FORWARDED_FOR']))
  {
   $IP = $_SERVER['HTTP_X_FORWARDED_FOR']; 
  }
  else 
  { 
   $IP = $_SERVER['REMOTE_ADDR'];
  }

  if(!in_array($IP, $allowed_ips)) 
  {
   echo "ERROR: Invalid source";
   return;
  }

  // Get postback variables
  $userId = isset($_REQUEST['subId']) ? $_REQUEST['subId'] : null;
  $transId = isset($_REQUEST['transId']) ? $_REQUEST['transId'] : null;
  $reward = isset($_REQUEST['reward']) ? $_REQUEST['reward'] : null;
  $reward_name = isset($_REQUEST['reward_name']) ? $_REQUEST['reward_name'] : null;
  $reward_value = isset($_REQUEST['reward_value']) ? $_REQUEST['reward_value'] : null;
  $offer_name = isset($_REQUEST['offer_name']) ? $_REQUEST['offer_name'] : null;
  $offer_type = isset($_REQUEST['offer_type']) ? $_REQUEST['offer_type'] : null;
  $payout = isset($_REQUEST['payout']) ? $_REQUEST['payout'] : null;
  $ipuser = isset($_REQUEST['userIp']) ? $_REQUEST['userIp'] : "0.0.0.0";
  $country = isset($_REQUEST['country']) ? $_REQUEST['country'] : null;
  $status = isset($_REQUEST['status']) ? $_REQUEST['status'] : null;
  $debug = isset($_REQUEST['debug']) ? $_REQUEST['debug'] : null;
  $signature = isset($_REQUEST['signature']) ? $_REQUEST['signature'] : null;

  // Validate signature
  if(md5($userId.$transId.$reward.$secret) != $signature)
  {
    echo "ERROR: Signature doesn't match";
    return;
  }

  // Add or substract the reward
  if($status == 2)
  {
    //  2 = Chargeback, substract reward from user
    $reward = -abs($reward);
  }

   // Check if the transaction is new, use $transId to valiate it
  if(isNewTransaction($transId))
  { 
    // Transaction is new, reward your user
    processTransaction($userId, $reward, $transId);
  }
  else
  {
    // This transaction already exist
  }

  echo "ok"; // Important!
?>

Intregrate Offerwall on Best Faucet Scripts

We have provide you some Best Faucet scripts intregartion method here,with this tutorial any faucet owner can easyly intregrate on there script

For evolution script you can find here the integration example!
Download link

Vie Faucet 4.3 Integration

It takes only three steps to integrate Ewall offerwall into your VieFaucet script.Please find below steps.

First open file - application/controllers/wh.php and enter the following code before last closing bracket (}).

Do not forget to enter your secret key under variable $secret from the Ewall's dashboard. Otherwise,your users will not be credited properly since postback will not work.

         public function ewall()
	  {
             $secret = ""; // UPDATE YOUR SECRET KEY
             $hold = 3;  // UPDATE HOLD DAYS IF YOU USE HOLD
             $minHold= 0.5; // Reward Lower than this amount will not be hold
            
             $userId = isset($_REQUEST['subId']) ? $this->db->escape_str($_REQUEST['subId']) : null;
             $transactionId = isset($_REQUEST['transId']) ? $this->db->escape_str($_REQUEST['transId']) : null;
             $reward = isset($_REQUEST['reward']) ? $this->db->escape_str($_REQUEST['reward']) : null;
             $action = isset($_REQUEST['status']) ? $this->db->escape_str($_REQUEST['status']) : null;
             $userIp = isset($_REQUEST['userIp']) ? $this->db->escape_str($_REQUEST['userIp']) : "0.0.0.0";
             $signature = isset($_REQUEST['signature']) ? $this->db->escape_str($_REQUEST['signature']) : null;
             if (md5($userId . $transactionId . $reward . $secret) != $signature) {
             echo "ERROR: Signature doesn't match";
             return;
             }
            
             $reward = $reward * $this->data['settings']['currency_rate'];
            
             $trans = $this->m_offerwall->getTransaction($transactionId, 'Ewall');
             if ($action == 2) {
             $this->m_offerwall->reduceUserBalance($userId, abs($reward));
             $this->m_offerwall->insertTransaction($userId, 'Ewall', $userIp, $reward, $transactionId, 1, time());
             echo "ok";
             } else {
		     if (!$trans) {
		     $hold = 0;
		     if ($reward > $minHold) {
		         $hold = 3; // UPDATE HOLD DAYS Which you Use for hold
		     	}
		    
		     if ($hold == 0) {
		     $offerId = $this->m_offerwall->insertTransaction($userId, 'Ewall', $userIp, $reward, $transactionId, 2, time());
		     $this->m_offerwall->updateUserBalance($userId, $reward);
		     $this->m_core->addNotification($userId, currency($reward, $this->data['settings']['currency_rate']) . " from Ewall Offer #" . $offerId . " was credited to your balance.", 1);
            
		     $user = $this->m_core->get_user_from_id($userId);
		     $this->m_core->addExp($user['id'], $this->data['settings']['offerwall_exp_reward']);
		     if (($user['exp'] + $this->data['settings']['offerwall_exp_reward']) >= ($user['level'] + 1) * 100) {
		     $this->m_core->levelUp($user['id']);
		     }
		     } else {
		     $availableAt = time() + $hold * 86400;
		     $offerId = $this->m_offerwall->insertTransaction($userId, 'Ewall', $userIp, $reward, $transactionId, 0, $availableAt);
		     $this->m_core->addNotification($userId, "Your Ewall Offer #" . $offerId . " is pending approval.", 0);
		     }
		     echo "ok";
		     } else {
		     echo "DUP";
		     }
	       }
        }	
        
        
        

Second step is to add our offerwall in the UI. Inside application/controllers/offerwall.php file, add this code before last closing bracket (}).

Don't forget to place on proper place your API key from the dashboard under $api_key variable.

            public function ewall()
	  {
		  $api_key=""; // UPDATE YOUR API KEY HERE
		 $this->data['page'] = 'Ewall Offerwall';
		 $this->data['iframe'] = '<iframe style="width:100%;height:800px;border:0;padding:0;margin:0;" scrolling="yes" frameborder="0" src="https://ewall.biz/offerwall/' . $api_key . '/' . $this->data['user']['id'] . '"></iframe>';
		 $this->data['wait'] = 3; // UPDATE YOUR HOLD TIME
		 $this->render('offerwall', $this->data);
	 }
          
          

Third step is to add Ewall's offerwall inside your sidebar/ UserPanel Menu on Vie Faucet.

Go to this file application/views/user_template/template.php, and place this code above or under some of the existing offerwalls list.

    <li><a href="<?= site_url('offerwall/ewall') ?>" key="t-ewall">Ewall</a></li>
          
          

Final Step You must Add below code on your config files

Open Application/Config/config.php

Goto $config['csrf_exclude_uris'] this line

Add this code 'wh/ewall', on that line.

How to set site on Ewall?

PostBack URL Should be : https://yourdomain.com/wh/ewall

Vie Faucet 4.4 Integration

It takes only three steps to integrate Ewall offerwall into your VieFaucet script.Please find below steps.

First open file - application/controllers/wh.php and enter the following code before last closing bracket (}).

Do not forget to enter your secret key under variable $secret from the Ewall's dashboard. Otherwise,your users will not be credited properly since postback will not work.

         public function ewall()
	  {
             $secret = ""; // UPDATE YOUR SECRET KEY
             $hold = 3;  // UPDATE HOLD DAYS IF YOU USE HOLD
             $minHold= 0.5; // Reward Lower than this amount will not be hold
            
             $userId = isset($_REQUEST['subId']) ? $this->db->escape_str($_REQUEST['subId']) : null;
             $transactionId = isset($_REQUEST['transId']) ? $this->db->escape_str($_REQUEST['transId']) : null;
             $reward = isset($_REQUEST['reward']) ? $this->db->escape_str($_REQUEST['reward']) : null;
             $action = isset($_REQUEST['status']) ? $this->db->escape_str($_REQUEST['status']) : null;
             $userIp = isset($_REQUEST['userIp']) ? $this->db->escape_str($_REQUEST['userIp']) : "0.0.0.0";
             $signature = isset($_REQUEST['signature']) ? $this->db->escape_str($_REQUEST['signature']) : null;
             if (md5($userId . $transactionId . $reward . $secret) != $signature) {
             echo "ERROR: Signature doesn't match";
             return;
             }
            
             $reward = $reward * $this->data['settings']['currency_rate'];
            
             $trans = $this->m_offerwall->getTransaction($transactionId, 'Ewall');
             if ($action == 2) {
             $this->m_offerwall->reduceUserBalance($userId, abs($reward));
             $this->m_offerwall->insertTransaction($userId, 'Ewall', $userIp, $reward, $transactionId, 1, time());
             echo "ok";
             } else {
		     if (!$trans) {
		     $hold = 0;
		     if ($reward > $minHold) {
		         $hold = 3; // UPDATE HOLD DAYS Which you Use for hold
		     	}
		    
		     if ($hold == 0) {
		     $offerId = $this->m_offerwall->insertTransaction($userId, 'Ewall', $userIp, $reward, $transactionId, 2, time());
		     $this->m_offerwall->updateUserBalance($userId, $reward);
		     $this->m_core->addNotification($userId, currencyDisplay($reward, $this->data['settings']) . " from Ewall Offer #" . $offerId . " was credited to your balance.", 1);
            
		     $user = $this->m_core->getUserFromId($userId);
		     $this->m_core->addExp($user['id'], $this->data['settings']['offerwall_exp_reward']);
		     if (($user['exp'] + $this->data['settings']['offerwall_exp_reward']) >= ($user['level'] + 1) * 100) {
		     $this->m_core->levelUp($user['id']);
		     }
		     } else {
		     $availableAt = time() + $hold * 86400;
		     $offerId = $this->m_offerwall->insertTransaction($userId, 'Ewall', $userIp, $reward, $transactionId, 0, $availableAt);
		     $this->m_core->addNotification($userId, "Your Ewall Offer #" . $offerId . " is pending approval.", 0);
		     }
		     echo "ok";
		     } else {
		     echo "DUP";
		     }
	       }
        }	
        
        
        

Second step is to add our offerwall in the UI. Inside application/controllers/offerwall.php file, add this code before last closing bracket (}).

Don't forget to place on proper place your API key from the dashboard under $api_key variable.

            public function ewall()
	  {
		  $api_key = ""; // UPDATE YOUR API KEY HERE
		 $this->data['page'] = 'Ewall Offerwall';
		 $this->data['iframe'] = '<iframe style="width:100%;height:800px;border:0;padding:0;margin:0;" scrolling="yes" frameborder="0" src="https://ewall.biz/offerwall/' . $api_key . '/' . $this->data['user']['id'] . '"></iframe>';
		 $this->data['wait'] = 3; // UPDATE YOUR HOLD TIME
		 $this->render('offerwall', $this->data);
	 }
          
          

Third step is to add Ewall's offerwall inside your sidebar/ UserPanel Menu on Vie Faucet.

Go to this file application/views/user_template/template.php, and place this code above or under some of the existing offerwalls list.

    <li><a href="<?= site_url('offerwall/ewall') ?>" key="t-ewall">Ewall</a></li>
          
          

Final Step You must Add below code on your config files

Open Application/Config/config.php

Goto $config['csrf_exclude_uris'] this line

Add this code 'wh/Ewall', on that line.

How to set site on Ewall?

PostBack URL Should be : https://yourdomain.com/wh/ewall

CryptoFaucet/ClaimBits Integration

ClaimBits/CryptoFaucet is a Very populer of Crypto Faucet which brings plenty of different features together into a complete system.

Ewall integration is very easy in this script - Just need to create 1 file, Modify 2 line of code, and that’s it! Less than 5 minutes and you can bring Ewall offerwall to your users.

To create Postback file - open system/gateways/ and create file ewall.php, put following code in this file:

                  
       <?php
        define('BASEPATH', true);
        require('../init.php');
        $secret = "YOUR SECRET KEY"; //Enter Your Ewall SECRET KEY
        
        $userId = isset($_REQUEST['subId']) ? $db->EscapeString($_REQUEST['subId']) : null;
        $survey = isset($_REQUEST['transId']) ? $db->EscapeString($_REQUEST['transId']) : null;
        $reward = isset($_REQUEST['reward']) ? $db->EscapeString($_REQUEST['reward']) : null;
        $payout = isset($_REQUEST['payout']) ? $db->EscapeString($_REQUEST['payout']) : null;
        $action = isset($_REQUEST['status']) ? $db->EscapeString($_REQUEST['status']) : null;
        $userIP = isset($_REQUEST['userIp']) ? $db->EscapeString($_REQUEST['userIp']) : '0.0.0.0';
        $country = isset($_REQUEST['country']) ? $db->EscapeString($_REQUEST['country']) : null;
        
        if (md5($userId.$survey.$reward.$secret) != $_REQUEST['signature']){
        echo "ERROR: Signature doesn't match";
        return;
        }
        if(!empty($userId) && $db->QueryGetNumRows("SELECT * FROM `completed_offers` WHERE `survey_id`='".$survey."' LIMIT 1") == 0)
        {
        $user = $db->QueryFetchArray("SELECT `id` FROM `users` WHERE `id`='".$userId."'");
        if(!empty($user['id'])) {
        $tc_points = (0.10*($payout*100));
        $tc_points = ($tc_points < 1 ? 1 : number_format($tc_points, 0));
        $db->Query("UPDATE `users` SET `ow_credits`=`ow_credits`+'".$reward."', `tasks_contest`=`tasks_contest`+'".$tc_points."' WHERE `id`='".$user['id']."'"); 
        $db->Query("INSERT INTO `users_offers` (`uid`,`total_offers`,`total_revenue`,`last_offer`) VALUES ('".$user['id']."','1','".$reward."','".time()."') ON DUPLICATE KEY UPDATE `total_offers`=`total_offers`+'1', `total_revenue`=`total_revenue`+'".$reward."', `last_offer`='".time()."'");
        $db->Query("INSERT INTO `completed_offers` (`user_id`,`survey_id`,`user_country`,`user_ip`,`revenue`,`reward`,`method`,`timestamp`) VALUES ('".$user['id']."','".$survey."','".$country."','".ip2long($userIP)."','".$payout."','".$reward."','Ewall','".time()."')");
        }
     }  
        echo 'ok';
       
       ?>
      
    

HOLA...Your, postback created Suceesfully! Now is time for iframe integration

Just Open template/default/pages/offers.php, and add the following code after some of the existing offerwalls. break; code.

    
           case 'ewall' :
           $title = 'Ewall';
           $offer_wall = '<iframe src="https://ewall.biz/offerwall/YOUR API KEY/'.$data['id'].'" style="width:100%;height:690px;border:0;border-radius:5px;"></iframe>';
            break;
    
    

.Replace YOUR API KEY by your Ewall API key from Ewall Website setting.

Scroll down and insert link to Ewall offerwall:

            
                 <a href="<?php echo GenerateURL('offers&x=ewall'); ?>" class="btn btn-secondary mb-1<?php echo ($method == 'ewall' ? ' active' : ''); ?>">Ewall</a>
                
                

And save, that is all!

What POSTBACK URL YOU NEED TO UPDATE IN Ewall POSTBACK URL?

Note: Currency should be set in credits

Postback URL should be : http://yourdomain.com/system/gateways/ewall.php

AutoFaucetScript - Ultimate Auto Faucet By NGB Solutions Integration

AutoFaucetScript is a Very populer of New Mordern AutoFaucet Script which brings plenty of different features together into a complete system.

Ewall integration is very easy in this script - Just need to create 1 file, Modify 2 line of code, and that’s it! Less than 5 minutes and you can bring Ewall offerwall to your users.

To create Postback file - open system/gateways/ and create file ewall.php, put following code in this file:

                  
       <?php
        define('BASEPATH', true);
        require('../init.php');
        $secret = "YOUR SECRET KEY"; //Enter Your Ewall SECRET KEY
        
        $userId = isset($_REQUEST['subId']) ? $db->EscapeString($_REQUEST['subId']) : null;
        $survey = isset($_REQUEST['transId']) ? $db->EscapeString($_REQUEST['transId']) : null;
        $reward = isset($_REQUEST['reward']) ? $db->EscapeString($_REQUEST['reward']) : null;
        $payout = isset($_REQUEST['payout']) ? $db->EscapeString($_REQUEST['payout']) : null;
        $action = isset($_REQUEST['status']) ? $db->EscapeString($_REQUEST['status']) : null;
        $userIP = isset($_REQUEST['userIp']) ? $db->EscapeString($_REQUEST['userIp']) : '0.0.0.0';
        $country = isset($_REQUEST['country']) ? $db->EscapeString($_REQUEST['country']) : null;
        
        if (md5($userId.$survey.$reward.$secret) != $_REQUEST['signature']){
        echo "ERROR: Signature doesn't match";
        return;
        }
        if(!empty($userId) && $db->QueryGetNumRows("SELECT * FROM `completed_offers` WHERE `survey_id`='".$survey."' LIMIT 1") == 0)
        {
        $user = $db->QueryFetchArray("SELECT `id` FROM `users` WHERE `id`='".$userId."'");
        if(!empty($user['id'])) {
        $currentPrice = $db->QueryFetchArray("SELECT `value` FROM `bitcoin_price` ORDER BY `time` DESC LIMIT 1");
        $usdPayout = $currentPrice['value']*$payout;
        $tc_points = (0.10*$usdPayout);
        $tc_points = ($tc_points < 1 ? 1 : number_format($tc_points, 0));
        $db->Query("UPDATE `users` SET `ow_credits`=`ow_credits`+'".$reward."', `tasks_contest`=`tasks_contest`+'".$tc_points."' WHERE `id`='".$user['id']."'"); 
        $db->Query("INSERT INTO `users_offers` (`uid`,`total_offers`,`total_revenue`,`last_offer`) VALUES ('".$user['id']."','1','".$reward."','".time()."') ON DUPLICATE KEY UPDATE `total_offers`=`total_offers`+'1', `total_revenue`=`total_revenue`+'".$reward."', `last_offer`='".time()."'");
        $db->Query("INSERT INTO `completed_offers` (`user_id`,`survey_id`,`user_country`,`user_ip`,`revenue`,`reward`,`method`,`timestamp`) VALUES ('".$user['id']."','".$survey."','".$country."','".ip2long($userIP)."','".$usdPayout."','".$reward."','Ewall','".time()."')");
        }
     }  
        echo 'ok';
       
       ?>
      
    

HOLA...Your, postback created Suceesfully! Now is time for iframe integration

Just Open template/default/pages/offers.php, and add the following code after some of the existing offerwalls. break; code.

    
           case 'ewall' :
           $title = 'Ewall';
           $offer_wall = '<iframe src="https://ewall.biz/offerwall/YOUR API KEY/'.$data['id'].'" style="width:100%;height:690px;border:0;border-radius:5px;"></iframe>';
            break;
    
    

💡.Replace YOUR API KEY by your Ewall API key from Ewall Website setting.

Scroll down and insert link to Ewall offerwall:

            
                 <a href="<?php echo GenerateURL('offers&x=ewall'); ?>" class="btn btn-secondary mb-1<?php echo ($method == 'ewall' ? ' active' : ''); ?>">Ewall</a>
                
                

And save, that is all!

What POSTBACK URL YOU NEED TO UPDATE IN Ewall POSTBACK URL?

Note: Currency should be set in credits

Postback URL should be : http://yourdomain.com/system/gateways/ewall.php