Developer Documentation

Website Integration

Embed the offerwall via HTML iFrame or JavaScript popup — replace [API_KEY] and [USER_ID] with your actual values.

PTC API Integration NEW

Fetch PTC campaign data directly and render it with your own UI. Useful when you want a fully custom look and feel.

JSON Response

{
  "success": true,
  "data": [
    {
      "id": "12",
      "title": "Crypto Faucet - Earn Free BTC",
      "description": "Claim free satoshis every 5 minutes!",
      "duration": "10",
      "reward": "15.00",
      "currency_name": "Coins",
      "url": "https://splitgrid.net/iframe.php?api_key=[API_KEY]&sub_id=[USER_ID]&view=ptc_surf&ad_id=12"
    }
  ]
}

Shortlink API Integration NEW

Query active shortlink campaigns available for your user.

Read Article API Integration NEW

Fetch available sponsored read-article campaigns for user engagement.

Offer API Integration NEW

Survey API Integration NEW

Android Integration

Open the offerwall in Chrome or embed it in a WebView inside your Android app.

WebView myWebView = new WebView(activityContext);
setContentView(myWebView);
WebSettings webSettings = myWebView.getSettings();
webSettings.setJavaScriptEnabled(true);
myWebView.loadUrl("https://splitgrid.net/iframe.php?api_key=[API_KEY]&sub_id=[USER_ID]");

iOS Integration

Open the offerwall in Safari or use WKWebView inside your iOS app.

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://splitgrid.net/iframe.php?api_key=[API_KEY]&sub_id=[USER_ID]")
        webView.load(URLRequest(url: myURL!))
    }
}

React Native

Use the Linking API to open in the system browser, or embed with react-native-webview.

import { Linking } from 'react-native';
Linking.openURL('https://splitgrid.net/iframe.php?api_key=[API_KEY]&sub_id=[USER_ID]');

Offerwall Parameters

Offerwall SDK (JS) NEW

A dependency-free, vanilla JavaScript SDK for building a fully custom offerwall UI on your own website. Every function returns raw data; there's no built-in HTML/CSS, so you have complete control over the look and feel.

<script src="https://splitgrid.net/sdk/SplitGrid-offerwall-sdk-v1.js"></script>

const wall = new SplitGridOfferwall({
  apiKey: '[API_KEY]', // required
  subId: '[USER_ID]', // required
  pagination: { enabled: true, pageSize: 10 }
});

wall.getOffers('surveys').then(result => {
  result.items.forEach(item => {
    console.log(item.title, '+' + item.reward);
  });
});

VieFaucet 4.3 Integration

Step 1 — Open application/controllers/wh.php and add this before the last closing bracket }:

public function SplitGrid() {
    $secret = "YOUR_SECRET_KEY"; // YOUR SECRET KEY
    $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;
    $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;
    }
    // ... complete processing code as per original documentation ...
    echo "ok";
}

Step 2 — Open application/controllers/offerwall.php and add the iframe view.

Step 3 — Add a menu link in application/views/user_template/template.php.

🔗 Set your Postback URL in SplitGrid dashboard to: https://yourdomain.com/wh/SplitGrid

VieFaucet 4.4 Integration

Integration for VieFaucet 4.4 follows the same steps as 4.3 with a minor difference in the notification helper function name (uses currencyDisplay() instead of currency()). Postback URL is the same: https://yourdomain.com/wh/SplitGrid

CryptoFaucet / ClaimBits Integration

Create the file system/gateways/SplitGrid.php:

<?php
define('BASEPATH', true);
require('../init.php');
$secret = "YOUR_SECRET_KEY";
$userId = $_REQUEST['subId'] ?? null;
$transId = $_REQUEST['transId'] ?? null;
$reward = $_REQUEST['reward'] ?? null;
$signature = $_REQUEST['signature'] ?? null;

if (md5($userId . $transId . $reward . $secret) != $signature) {
    echo "ERROR: Signature doesn't match"; exit;
}
// Credit user logic here
echo "ok";

📌 Currency must be set to credits. Postback URL: http://yourdomain.com/system/gateways/SplitGrid.php

Postback Parameters

Security & Signature

Always verify the signature parameter to confirm the postback originates from SplitGrid servers. SplitGrid sends both algorithms so you can choose which one fits your backend:

// Sort all received parameters alphabetically by key (excluding 'signature'), concatenate values separated by your secretKey:
ksort($params); // remove $params['signature'] first
$stringToSign = implode($secretKey, $params);
$expectedSig = hash('sha256', $stringToSign);

$expectedMd5 = md5($subId . $transId . $reward . $secretKey);

You can find your Secret Key and Bearer Token in the My Apps section of your publisher dashboard.

Expected Server Response

When your postback script successfully credits the user, your server must respond with HTTP 200 and print:

OK

Any response other than "OK" (or a non-200 HTTP code) will cause the postback to be logged as failed and queued for automatic retry.

Full PHP Postback Example

<?php
$secretKey = "YOUR_APP_SECRET_KEY";

$subId     = $_REQUEST['subId']     ?? '';
$transId   = $_REQUEST['transId']   ?? '';
$reward    = $_REQUEST['reward']    ?? '';
$signature = $_REQUEST['signature'] ?? '';

// Validate signature
$expectedSig = md5($subId . $transId . $reward . $secretKey);
if ($signature !== $expectedSig) {
    http_response_code(403);
    exit("ERROR: Invalid Signature");
}

// TODO: Credit user in your database with $reward points/currency

// Always print OK on success
echo "OK";