Enterprise REST API & Tariff Mesh

Returns merchant live float, sandbox balance, KYC status, and dedicated bank account details.

curl -X GET "https://api.azabazaar.com/api/wallet/balance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Environment: live" \
  -H "Accept: application/json"

<?php
$ch = curl_init('https://api.azabazaar.com/api/wallet/balance');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Accept: application/json']
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($res);

const axios = require('axios');
const { data } = await axios.get('https://api.azabazaar.com/api/wallet/balance', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
console.log(data);

import requests
res = requests.get('https://api.azabazaar.com/api/wallet/balance', headers={'Authorization': 'Bearer YOUR_API_KEY'})
print(res.json())

{
  "status": true,
  "mode": "live",
  "kyc": {
    "status": "verified",
    "is_verified": true,
    "can_go_live": true
  },
  "currency": "NGN",
  "balance": 184500.50,
  "live_balance": 184500.50,
  "sandbox_balance": 100000.00,
  "dedicated_account": {
    "bank_name": "Wema Bank",
    "account_number": "9817611700",
    "account_name": "Merchant Business"
  },
  "settlement_account": {
    "bank_name": "OPay",
    "account_number": "9137760004",
    "account_name": "MERCHANT OWNER"
  }
}

Vends Airtime or Data directly to recipient phone number across MTN, Airtel, Glo, or 9mobile.

{
  "service_category": "data",
  "service_id": "MT-0153",
  "phone": "08069309367",
  "network_id": 1,
  "idempotency_key": "trx_BFC0871FB3AF"
}

{
  "status": true,
  "mode": "live",
  "order_reference": "AZB-VTU-7624D0855896",
  "recipient": "08069309367",
  "amount_charged": 420.00,
  "order_status": "successful",
  "message": "Data bundle recharged successfully."
}

Queries the delivery status of any previously submitted transaction reference.

Requests a network operator carrier OTP to be delivered via SMS to the sender's mobile phone.

{
  "phone": "08069309367",
  "network": "MTN",
  "amount": 2500.00
}

{
  "status": true,
  "network": "MTN",
  "sender": "08069309367",
  "message": "Verification code dispatched to your MTN line (08069309367) via SMS."
}

Validates the received carrier OTP and returns an authenticated session_id (or identifier) needed for Step 3 liquidation.

{
  "phone": "08069309367",
  "network": "MTN",
  "otp": "12345"
}

{
  "status": true,
  "network": "MTN",
  "session_id": "SES-CARRIER-SBX-1156AE2AB044",
  "identifier": "SES-CARRIER-SBX-1156AE2AB044",
  "message": "MTN line authenticated successfully."
}

Deducts airtime from the SIM line via carrier gateway and automatically disburses cash directly to the recipient's bank account.

{
  "phone": "08069309367",
  "network": "MTN",
  "amount": 5000.00,
  "share_pin": "0000",
  "identifier": "SES-CARRIER-SBX-1156AE2AB044",
  "bank_code": "999992",
  "account_number": "9137760004",
  "account_name": "Merchant Owner"
}

{
  "status": true,
  "order_id": "89b78291-5341-4770-98b7-60e101150821",
  "network": "MTN",
  "amount_cashed": 4000.00,
  "reference": "TRF-7B9A284C",
  "message": "MTN airtime conversion successful! ₦4,000.00 has been sent to MERCHANT OWNER."
}

Queues a manual Share 'N' Sell USSD transfer order to our platform SIM pools with instant bank disbursement upon detection.

{
  "sender_phone": "08069309367",
  "network": "MTN",
  "amount": 2000.00,
  "bank_code": "058",
  "account_number": "0123456789"
}

Submits an unredeemed 10 to 18-digit physical recharge card PIN for automated audit and direct bank settlement.

{
  "phone": "08069309367",
  "network": "MTN",
  "amount": 1000.00,
  "card_pin": "5482910481928471",
  "bank_code": "999992",
  "account_number": "9137760004"
}

Phase 1: Validates customer account or smartcard number before vending.

{
  "service_code": "ikeja-electric",
  "customer_account": "11111111111",
  "meter_type": "prepaid"
}

Phase 2: Debits merchant float and dispenses electricity token or activates cable TV.

{
  "status": true,
  "mode": "live",
  "reference": "AZB-BIL-8994AC22",
  "token": "4521-8894-1102-8849-0192",
  "units": "45.2 kWh",
  "amount_charged": 5000.00
}

Fetches live NIP bank codes, commercial banks, and licensed microfinance institutions.

Resolves 10-digit NUBAN account name against NIP central switches.

{
  "account_number": "0123456789",
  "bank_code": "058"
}

Initiates direct bank transfer from your float balance.

{
  "account_number": "9137760004",
  "bank_code": "999992",
  "amount": 25000.00,
  "narration": "Wholesale Settlement",
  "pin": "123456"
}

Acquires an active international phone number to receive verification SMS OTPs.

{
  "service_id": "wa",
  "country_code": "US"
}