DEVELOPER DOCUMENTATION

API Reference

Build high-performance monetization experiences. Integrate Bagira Wall's premium offer inventory into your web or mobile application in minutes.

Getting Started

Create your Identity

Register at Bagira Wall and verify your publisher profile to access the developer dashboard.

Register a Property

Navigate to Websites and click "Add New Site". Each site receives a unique API and Secret key.

Define Payouts

Set your virtual currency name (e.g., Credits, Gold) and the exchange rate (e.g., 1000 credits = $1.00).

Iframe Integration

Integrating the Offerwall into your digital property is a simple process. Use your unique Property ID to identify the property and track user completions.

HTML Iframe Implementation

Copy and paste this code into your website. It provides a responsive, sandboxed environment for your users.

HTML Iframe Embed

<!-- Easy Integration -->
<iframe 
    src="https://bagirawall.com/offerwall/[PROPERTY_ID]/[USER_ID]" 
    style="width:100%; height:800px; border:none; border-radius:16px;"
    allow="geolocation; camera;">
</iframe>

Parameter	Description	Example
`[PROPERTY_ID]`	Your numeric Property ID (found in integration keys).	`102`
`[USER_ID]`	Internal ID of the user in your database (to track rewards).	`user_123`

Postback Notification

Every time a user completes an offer, our engine triggers a real-time server-to-server GET request to your configured endpoint.

URL Macro Support

You can define your postback URL using placeholders. Our system will automatically inject the data into your specified format.


                    https://your-site.com/callback?uid={user_id}&reward={amount}&tid={transaction_id}

If no placeholders are used, all parameters will be appended to your URL as a standard query string.

Parameter	Type	Description
`user_id`	string	The unique ID you passed in the URL.
`amount`	float	Currency amount to credit (pre-calculated based on your rate).
`currency`	string	The name of your virtual currency (e.g., Points).
`revenue`	float	The USD payout for your account (Publisher Earnings).
`transaction_id`	string	Unique hash for this completion event.
`offer_title`	string	The name of the offer completed by the user.
`offer_id`	string	The unique ID of the offer from the network.
`status`	int	`1` = Credit, `2` = Chargeback.
`ip_address`	string	The IP address of the user who completed the offer.
`country_code`	string	2-letter ISO country code of the user.
`timestamp`	int	Unix timestamp of the completion event.
`sig`	string	Security signature for verification.

Signature Verification

To ensure requests originate from Bagira Wall, calculate the MD5 hash of the parameters and compare it against the sig parameter.

PHP Security Logic

<?php
$secret = "YOUR_SECRET_KEY"; // Found in Dashboard

$uid   = $_GET['user_id'];
$tid   = $_GET['transaction_id'];
$amt   = $_GET['amount'];
$sig   = $_GET['sig'];

// Verification Algorithm
$local_sig = md5($uid . $tid . $amt . $secret);

if ($local_sig !== $sig) {
    http_response_code(403);
    die("Verification Failed");
}

// Process user credit logic here...
echo "ok"; // Important: always return "ok" to prevent retries
?>