Integration Documentation

<!-- Responsive Offerwall Embed -->
<iframe 
    src="https://veloxoffer.com/wall?api_key=YOUR_API_KEY&user_id=USER_12345" 
    style="width: 100%; height: 850px; border: none; border-radius: 8px;" 
    allow="geolocation; camera" 
    loading="lazy">
</iframe>

// Android WebView Setup
val webView = findViewById<WebView>(R.id.offerwallWebView)
webView.settings.apply {
    javaScriptEnabled = true
    domStorageEnabled = true
    databaseEnabled = true
    setSupportMultipleWindows(true)
}
webView.webViewClient = WebViewClient()

val apiKey = "YOUR_API_KEY"
val userId = currentUser.id
webView.loadUrl("https://veloxoffer.com/wall?api_key=$apiKey&user_id=$userId")

curl -X GET "https://veloxoffer.com/api?pub_id=1042&placement_id=85&device=Android&country_name=US"      -H "Accept: application/json"

<?php
$appSecret = "YOUR_PLACEMENT_SECRET_KEY";
$receivedSecret = $_GET['secret'] ?? '';

if (!hash_equals($appSecret, $receivedSecret)) {
    http_response_code(403);
    exit('Unauthorized secret key');
}
// Secret key verified. Proceed with credit...

<?php
/**
 * VeloxOffer Production Postback Receiver
 * URL: https://yoursite.com/postback.php?user_id={user_id}&reward={reward}&payout={payout}&txn_id={txn_id}&status={status}&offer_id={offer_id}&secret={secret}
 */
header('Content-Type: text/plain');

$SECRET_KEY = 'YOUR_PLACEMENT_SECRET_KEY';

// 1. Read parameters
$userId  = $_GET['user_id'] ?? '';
$reward  = floatval($_GET['reward'] ?? 0);
$payout  = floatval($_GET['payout'] ?? 0);
$txnId   = $_GET['txn_id'] ?? '';
$status  = intval($_GET['status'] ?? 1); // 1 = Approved, 2 = Reversal
$offerId = $_GET['offer_id'] ?? '';
$secret  = $_GET['secret'] ?? '';

// 2. Validate Secret
if (!hash_equals($SECRET_KEY, $secret)) {
    http_response_code(403);
    exit("Invalid secret key");
}

if (empty($userId) || empty($txnId)) {
    http_response_code(400);
    exit("Missing parameters");
}

// 3. Database connection & Deduplication
try {
    $pdo = new PDO('mysql:host=localhost;dbname=your_db;charset=utf8mb4', 'db_user', 'db_pass', [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
    ]);

    // Check if txn_id was already handled
    $stmt = $pdo->prepare("SELECT id FROM transactions WHERE txn_id = ?");
    $stmt->execute([$txnId]);
    if ($stmt->fetch()) {
        exit("1"); // Already processed, acknowledge receipt
    }

    // 4. Update user balance
    if ($status === 1) {
        $pdo->beginTransaction();
        $pdo->prepare("UPDATE users SET points = points + ? WHERE id = ?")->execute([$reward, $userId]);
        $pdo->prepare("INSERT INTO transactions (user_id, txn_id, offer_id, reward, payout, status, created_at) VALUES (?, ?, ?, ?, ?, 'approved', NOW())")
            ->execute([$userId, $txnId, $offerId, $reward, $payout]);
        $pdo->commit();
    } elseif ($status === 2) {
        $pdo->beginTransaction();
        $pdo->prepare("UPDATE users SET points = GREATEST(0, points - ?) WHERE id = ?")->execute([$reward, $userId]);
        $pdo->prepare("INSERT INTO transactions (user_id, txn_id, offer_id, reward, payout, status, created_at) VALUES (?, ?, ?, ?, ?, 'reversed', NOW())")
            ->execute([$userId, $txnId, $offerId, -$reward, -$payout]);
        $pdo->commit();
    }

    // 5. Must return 1
    echo "1";

} catch (Exception $e) {
    if (isset($pdo) && $pdo->inTransaction()) {
        $pdo->rollBack();
    }
    http_response_code(500);
    echo "Error: " . $e->getMessage();
}