bxwall Documentation

1. Overview & Key Features

bxwall is an enterprise-grade, high-performance CPA Offerwall, PTC (Pay-To-Click), and Reward Network PHP Web Script built on top of the robust Laravel 12 framework with real-time Livewire 3 reactive UI components.

Designed specifically for Webmasters, Network Owners, Publishers, and Advertisers, bxwall allows you to launch your own Offerwall monetization service, PTC ad platform, and rewarded payout system in minutes.

2. Server Requirements

Before installing bxwall, please ensure your web server environment satisfies the following minimum technical requirements:

3. Installation & Setup Guide

Follow these step-by-step instructions to get bxwall running on your server:

1. Upload Project Files

   Extract the contents of your downloaded bxwall.zip archive and upload all files to your web server root directory (e.g. public_html/ or domain document root).

2. Create MySQL Database

   Log into your cPanel / Plesk or phpMyAdmin dashboard and create a fresh MySQL database (e.g. bxwall_db). Create a database user and assign full permissions to the database.

3. Configure Environment File (.env)

   In the root directory, locate the .env file (or rename .env.example to .env if needed). Edit the database connection parameters:

   File: .env Copy
   APP_NAME=bxwall
   APP_ENV=production
   APP_KEY=
   APP_DEBUG=false
   APP_URL=https://yourdomain.com
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=bxwall_db
   DB_USERNAME=your_db_username
   DB_PASSWORD=your_db_password

4. Generate App Key & Run Migrations

   Run the following Artisan terminal commands from your root directory:

   Terminal / SSH Command Copy
   php artisan key:generate
   php artisan migrate --seed
   php artisan storage:link

   No SSH Access?

   If your hosting provider does not support SSH console commands, you can execute web utility routes provided in bxwall:

   • https://yourdomain.com/link — Creates storage symlink automatically.
   • https://yourdomain.com/clear — Clears system cache, config, and views.

5. Set Directory Permissions

   Ensure the following directories are recursively writable by your web server process (chmod 775 or 777):

   • storage/
   • bootstrap/cache/

4. Database Reset Utility (`clean_db.php`)

bxwall includes a dedicated script named clean_db.php in the main project directory. This tool allows site administrators and developers to instantly wipe sample data, user activity, test campaigns, and logs before launching a clean production instance.

How to Run Database Cleanup

From your terminal / command prompt in the root project directory, execute:

Terminal Command Copy
php clean_db.php

5. Cron Job & Task Scheduler

bxwall requires a single background Cron Job to automate offer status checks, PTC campaign verification, referral commissions, and log rotation.

Setting Up Server Cron Job

Log into your hosting server cPanel or server crontab and add the following entry set to run every minute (* * * * *):

Crontab Command Copy
* * * * * cd /path/to/your/bxwall && php artisan schedule:run >> /dev/null 2>&1

6. Admin Dashboard Guide

Access the powerful Admin Control Panel at https://yourdomain.com/login using your administrator credentials. (Note: User accounts and Administrator accounts share the exact same /login portal for signing in).

Key Admin Management Areas

• General Settings (/setting/general): Configure Site Title, Base Currency Symbol, Logo & Favicon uploads, system emails.
• User Management (/users): Manage registered users, view balance histories, ban spammers, or manually credit/debit balances.
• Deposit Gateways (/gateway/list): Enable/disable automated gateways (CoinGate, Mollie) or configure custom manual offline deposit gateways.
• Withdrawal Methods (/withdraw/methods): Set up cashout methods (PayPal, Crypto, Gift Cards, Bank Transfer) with minimum/maximum limits and processing fees.

7. Publisher Offerwall Integration Guide

Publishers can monetize their apps and websites by embedding the bxwall responsive offerwall iframe.

Iframe Embed Code

Publishers place the following responsive HTML iframe snippet into their web pages, replacing pub_id and sub_id dynamically:

HTML Embed Code Copy
<iframe 
  src="https://yourdomain.com/user/offers?pub_id=PUBLISHER_ID&sub_id=USER_ID" 
  width="100%" 
  height="800px" 
  style="border:none; border-radius:12px; shadow:0 4px 12px rgba(0,0,0,0.1);"
  allow="fullscreen">
</iframe>

8. Postback & Webhook Integration

When a user completes an offer, network postback callbacks notify your bxwall server to automatically credit user rewards.

Postback URL Syntax

Provide your network partners with your postback listener URL:

Postback URL Format Copy
https://yourdomain.com/api/postback?sub_id={user_id}&payout={reward}&tx_id={transaction_id}&status={status}

9. Advertiser & PTC Campaign Setup

Advertisers can purchase Pay-To-Click (PTC) ad space to drive targeted traffic to their landing pages.

• Campaign Budgets: Advertisers set total click limits and daily click caps.
• Verification Timer: Viewers must remain on advertiser landing pages for a specified duration (e.g. 10 to 60 seconds) with active window detection before reward validation.

10. Payment & Payouts Setup

bxwall offers multi-currency automated deposits and customizable withdrawal methods for users and advertisers.

Configuring Automated & Manual Payment Gateways

1. Navigate to Admin Panel → Payment Gateways → Automatic Gateways (e.g. Mollie).
2. Enter your API credentials / secret keys and click Save Changes.
3. To configure custom withdrawal/deposit methods (PayPal, Bank Transfer, Gift Cards), navigate to Payment Gateways → Manual Gateways and set custom instructions and fields.

11. Anti-Fraud & Security System

bxwall comes integrated with strict anti-fraud safeguards to block malicious users and proxy abuse.

• ProxyCheck API Integration: Real-time detection of VPN, Tor, and Proxy IP addresses.
• Device Fingerprinting & Agent Detection: Prevents automated bots and duplicate account registrations per device.
• Spammer Blacklist: Automated banning of suspicious IP ranges and repeated failed conversion attempts.

12. FAQ & Troubleshooting Guide

13. Customer Support

Thank you for choosing bxwall! We provide dedicated technical support to all customers holding a valid software license.