v1.0.4 Global Release

Global Payments Api

Integrate real-time VTU, Bill Payments, and multi-currency transactions across borders. WiseMz handles local routing automatically.

Cross-Border Authentication

Pass your region dynamically using the X-Country-Code header. Defaults to NG (Nigeria).

Authorization: Bearer WHS_TEST_XXXXXXXX

X-Country-Code: NG // Supported: NG, NE, GH, KE, US, GB, EU

Core Endpoints

GET /Api/v1/balance

Retrieve your current wallet balance in your local currency.

POST /Api/v1/data

Purchase SME, Corporate, or Gifting data bundles instantly.

POST /Api/v1/airtime

Purchase instant airtime. Pass `amount` and `network`.

Service Plan Dictionary

Use these exact Plan IDs when constructing your JSON payload for Data and Bill endpoints.

MTN Data (Network ID: 1)

Plan Name	Plan ID	Price (₦)	Type
500MB (30 Days)	6	140	SME
1GB (30 Days)	7	260	SME
2GB (30 Days)	8	520	SME
5GB (30 Days)	11	1300	SME

GLO Data (Network ID: 2)

Plan Name	Plan ID	Price (₦)	Type
1.05GB (14 Days)	20	450	Gifting
2.9GB (30 Days)	21	950	Gifting
5.8GB (30 Days)	22	1900	Gifting

Airtel Data (Network ID: 4)

Plan Name	Plan ID	Price (₦)	Type
750MB (14 Days)	35	500	Corporate
1.5GB (30 Days)	36	1000	Corporate
3.0GB (30 Days)	37	1500	Corporate

9Mobile Data (Network ID: 3)

Plan Name	Plan ID	Price (₦)	Type
1.5GB (30 Days)	40	1000	Corporate
2.0GB (30 Days)	41	1200	Corporate

Bill Service IDs

Service Name	Service ID	Category
Kano Electricity (KEDCO)	kedco	Electricity
Abuja Electricity (AEDC)	aedc	Electricity
Eko Electricity (EKEDC)	ekedc	Electricity
DSTV Subscription	dstv	Cable TV
GOTV Subscription	gotv	Cable TV
Startimes	startimes	Cable TV

Webhooks

WiseMz uses webhooks to notify your application when an asynchronous event occurs.

Event Type	Trigger Description
transaction.success	Fired when a VTU/Bill transaction successfully delivers.
transaction.failed	Fired when a transaction fails and is refunded.

Download SDKs

Python SDK

DOWNLOAD

Node.js SDK

DOWNLOAD

buy_data.php

// WHS WiseMz Global Api Integration
$Api_url = "https://pay.wisehivesphere.com/Api/v1/data";

$data = [
    "network" => 1,
    "plan"    => "7",
    "phone"   => "+2348066540390"
];

$ch = curl_init($Api_url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer WHS_TEST_XXXXXXXX",
    "X-Country-Code: NG",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
echo curl_exec($ch);

multi_currency_response.json

{
  "status": "success",
  "message": "Transaction Successful",
  "data": {
    "reference": "WHS-INT-99812",
    "network": "MTN_NG",
    "amount_local": 260.00,
    "currency_local": "NGN",
    "amount_usd": 0.17
  },
  "environment": "sandbox"
}

webhook_payload.json

{
  "event": "transaction.success",
  "data": {
    "reference": "WHS-INT-99812",
    "network": "MTN_NG",
    "amount": 260.00,
    "status": "delivered",
    "delivered_at": "2026-02-22T20:30:00Z"
  }
}

Support & Error Handling

Understand standard WHS HTTP status codes and Api limits.

HTTP Status Codes

200 OKEverything worked as expected.

400 Bad RequestMissing required parameters.

401 UnauthorizedInvalid or missing Api Key.

402 Payment RequiredInsufficient Wallet Balance.

429 Too Many RequestsRate limit exceeded (60/min).

Open a Developer Ticket

Need integration help? Our engineers are on standby.

Interactive Sandbox

Current Environment: TEST

Construct Request

Api Key

Region

Network

Phone Number

HTTP RESPONSE Awaiting Transmission...

{ "status": "idle" }

GLOBAL CLUSTER LOGS

System Monitor initialized on WHS Root Server...

Developer Tools

JSON Formatter

Base64 Credentials

Encode Basic Auth strings (client_id:client_secret).

Webhook Event Tester

Generate a mock WiseMz webhook payload.

Root Access Terminal

admin@wisehive:~$

WHS Dev Lab

Experimental tech and internal research projects currently under development.

Sphere World Assistant

Cross-platform automation tool for enterprise workflows.

Alpha 0.4

WHS Neural Core

LLM optimization for Hausa/French language translation.

Researching