ALU API Developer Documentation
Complete REST API reference for automated BGMI UC instant delivery, player UID lookups, catalog pricing, and webhook order fulfillment.
1. Overview & Authentication
ALU API is an API-first service platform for gaming merchants, esports organizations, and top-up resellers. All endpoints use JSON for requests and responses.
https://aluu.in
Authentication Header
Pass your secret API key with every request using the x-api-key HTTP header:
x-api-key: ak_live_047166892225d25427574691917791d8e25f3a29ef210b40cf2a978e3ac025b3
2. IP Whitelisting Requirement
For security, ALU API restricts player name checking endpoints to whitelisted server IPs.
/api/v.1/balance
Retrieve your current live merchant wallet balance and currency.
cURL Example:
curl -X GET "https://aluu.in/api/v.1/balance" \ -H "x-api-key: ak_live_04...3ac025b3" \ -H "Accept: application/json"
Success Response (200 OK):
{
"success": true,
"data": {
"wallet_balance": 0.00,
"currency": "USD"
}
}
/api/check/bgmi?gameCode=bgmi&id={uid}
Look up Battlegrounds Mobile India player character nickname and account validity before placing an order.
Query Parameters:
| Param | Type | Required | Description |
|---|---|---|---|
| gameCode | string | Yes | Set to bgmi |
| id | string | Yes | BGMI Player User ID (8–12 digits) |
Success Response (200 OK):
{
"success": true,
"player_name": "Mortal_GOD",
"uid": "5123456789",
"level": 64
}
/api/v.1/products/bgmi_instant
Retrieve official catalog denominations and pricing for BGMI Instant UC packs.
Available Pack Codes Reference:
| Pack Code | Denomination | API Price | Delivery |
|---|---|---|---|
| bgmi_13uc | 13 UC (12 + 1 Bonus) | $0.13 USD | Instant API |
| bgmi_26uc | 26 UC (24 + 2 Bonus) | $0.26 USD | Instant API |
| bgmi_66uc | 66 UC (60 + 6 Bonus) | $0.68 USD | Instant API |
| bgmi_360uc | 360 UC (300 + 60 Bonus) | $3.50 USD | Instant API |
| bgmi_720uc | 720 UC (600 + 120 Bonus) | $6.78 USD | Instant API |
| bgmi_1950uc | 1950 UC (1500 + 450 Bonus) | Standard Rate | Instant API |
| bgmi_4050uc | 4050 UC (3000 + 1050 Bonus) | Standard Rate | Instant API |
| bgmi_8400uc | 8400 UC (6000 + 2400 Bonus) | Standard Rate | Instant API |
| bgmi_18180uc | 18180 UC (13040 + 5140 Bonus) | Standard Rate | Instant API |
/api/v.1/bgmi-instant/create
Place an instant UC delivery request. The order is processed in real time and charged against your ALU wallet.
Request Body (JSON):
{
"player_id": "5123456789",
"pack": "bgmi_66uc",
"partner_orderid": "ORD-2026-98124",
"webhook_url": "https://demo2.alphademo.site/api/webhook-alu.php"
}
Success Response (200 OK):
{
"success": true,
"order_id": "ALU-98471203",
"status": "completed",
"partner_orderid": "ORD-2026-98124",
"player_id": "5123456789",
"pack": "bgmi_66uc",
"amount_charged": 0.68,
"currency": "USD"
}
7. Webhooks & HMAC-SHA256 Signatures
When fulfillment updates happen, ALU API sends a signed POST request to your specified webhook_url. Verify the HMAC signature to ensure authenticity.
PHP Verification Snippet:
<?php
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$timestamp = $_SERVER['HTTP_X_WEBHOOK_TIMESTAMP'] ?? '';
$secret = 'YOUR_WEBHOOK_SECRET';
// Prevent replay attacks (5 minute window)
if (abs(time() - (int)$timestamp) > 300) {
http_response_code(401);
exit('Timestamp expired');
}
$expected = hash_hmac('sha256', "{$timestamp}.{$payload}", $secret);
if (!hash_equals($expected, $signature)) {
http_response_code(403);
exit('Invalid signature');
}
// Process order fulfillment payload
$data = json_decode($payload, true);
// $data['order_id'], $data['status'], etc.
?>
Interactive Live API Tester
Execute real API requests directly against ALU API endpoints using your active credentials.
Click "Send Live Request" to test endpoint...