DSSMSHUB API

Integrate our services — Virtual Numbers, Data, Airtime, Electricity, Social Boost, and Betting — directly into your own website or mobile app.

Authentication

All API requests require your API key. You can get your key from your Account → API Settings page.

Pass your key in the POST body as key or in the HTTP header:

Authorization: Bearer YOUR_API_KEY

Request Format

All endpoints use POST. You can send either application/x-www-form-urlencoded or application/json:

POST https://dssmshub.com.ng/api
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "endpoint": "account/balance"
}

Error Codes

Every error response includes status: "error", a code string, and a human-readable message:

{
  "status": "error",
  "code": "INSUFFICIENT_BALANCE",
  "message": "Insufficient balance. Required: ₦850.00, Available: ₦200.00"
}

Account Endpoints

// Request
{ "key": "YOUR_KEY", "endpoint": "account/balance" }

// Response
{
  "status": "success",
  "wallet_balance": 5000.00,
  "referral_balance": 200.00,
  "currency": "NGN"
}

{ "key": "YOUR_KEY", "endpoint": "account/profile" }

{ "key": "YOUR_KEY", "endpoint": "account/transactions" }

Virtual Numbers (OTP)

{ "key": "YOUR_KEY", "endpoint": "numbers/services" }

{ "key": "YOUR_KEY", "endpoint": "numbers/countries" }

// Request
{
  "key": "YOUR_KEY",
  "endpoint": "numbers/buy",
  "service": "whatsapp",
  "country": "1"
}

// Success Response
{
  "status": "success",
  "orderid": "123456789",
  "number": "+14155552671",
  "cost": 850.00,
  "currency": "NGN"
}

{ "key": "YOUR_KEY", "endpoint": "numbers/check", "orderid": "123456789" }

{ "key": "YOUR_KEY", "endpoint": "numbers/cancel", "orderid": "123456789" }

Data Bundles

{ "key": "YOUR_KEY", "endpoint": "data/plans", "network": "mtn" }

{
  "key": "YOUR_KEY",
  "endpoint": "data/buy",
  "network": "mtn",
  "plan_id": "mtn-500mb-30days",
  "phone": "08012345678",
  "amount": 250
}

Airtime

{
  "key": "YOUR_KEY",
  "endpoint": "airtime/buy",
  "network": "mtn",
  "phone": "08012345678",
  "amount": 500
}

Electricity

Social Media Boost

{ "key": "YOUR_KEY", "endpoint": "social/services" }

{ "key": "YOUR_KEY", "endpoint": "social/status", "order_id": "12345" }

Betting Wallets

Code Examples

PHP Example — Buy Airtime

<?php
$apiKey = 'YOUR_API_KEY'; // Keep this on the server

$response = file_get_contents('https://dssmshub.com.ng/api', false,
    stream_context_create(['http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/json',
        'content' => json_encode([
            'key'      => $apiKey,
            'endpoint' => 'airtime/buy',
            'network'  => 'mtn',
            'phone'    => '08012345678',
            'amount'   => 500
        ])
    ]])
);

$result = json_decode($response, true);

if ($result['status'] === 'success') {
    echo "Airtime sent! Reference: " . $result['reference'];
} else {
    echo "Error: " . $result['message'];
}
?>

JavaScript (Node.js) — Buy a Virtual Number

const axios = require('axios');

const response = await axios.post('https://dssmshub.com.ng/api', {
  key:      'YOUR_API_KEY',
  endpoint: 'numbers/buy',
  service:  'whatsapp',
  country:  '1'
});

if (response.data.status === 'success') {
  console.log('Number:', response.data.number);
  console.log('Order ID:', response.data.orderid);
} else {
  console.error('Failed:', response.data.message);
}

Python — Check Balance

import requests

res = requests.post('https://dssmshub.com.ng/api', json={
    'key':      'YOUR_API_KEY',
    'endpoint': 'account/balance'
})

data = res.json()
if data['status'] == 'success':
    print(f"Balance: ₦{data['wallet_balance']}")