Developer API Documentation | MoreValueDigital

Authentication

All API requests must include your private secret token passed in the request header. You can generate or refresh your key inside your developer dashboard.

Header Format:
Token: Token your_api_key_here

Notice: To protect reseller margins, live Plan IDs and wholesale vendor pricing tables are confidential. You must Register or Login to access your live developer IDs.

Header Authentication Example

Token: Token sk_live_968fc8869583f3fbc60bac1e1f1089f6
Content-Type: application/json

Base URL

https://morevaluedigital.com.ng/api/

Testing with Postman

You can easily test our API endpoints using Postman before writing any code. Follow these steps to make your first test request:

Set the HTTP method to POST.
Enter the API endpoint URL (e.g., https://morevaluedigital.com.ng/api/data/).
Go to the Headers tab and add two rows:
- Token : Token sk_live_your_api_key
- Content-Type : application/json
Go to the Body tab, select raw, and change the format to JSON. Paste your request data.
Click Send.

Postman Headers Setup

Key: Token
Value: Token sk_live_YOUR_API_KEY_HERE

Key: Content-Type
Value: application/json

Postman Body Setup (Raw JSON)

{
    "network": "1",
    "plan": "10",
    "phone": "08149659347",
    "ref": "POSTMAN_TEST_1001"
}

GET

Check Wallet Balance

https://morevaluedigital.com.ng/api/user/

Query your current account wallet balance and profile status.

cURL Request

curl --location 'https://morevaluedigital.com.ng/api/user/' \
--header 'Token: Token sk_live_your_key' \
--header 'Content-Type: application/json'

Sample Response

{
    "status": "success",
    "balance": 5450.00,
    "account_type": "Vendor"
}

POST

Purchase Data Bundle

https://morevaluedigital.com.ng/api/data/

Dispense SME, Gifting, or Corporate data to any Nigerian telecom network.

Field	Type	Description
`network` *	string	`1`=MTN, `2`=GLO, `3`=9Mobile, `4`=Airtel
`plan` *	string	The Data Plan ID from your logged-in dashboard table.
`phone` *	string	The 11-digit recipient phone number.
`ref`	string	Optional unique reference string to prevent duplicate orders.

Request Body (JSON)

{
    "network": "1",
    "plan": "420",
    "phone": "08149659347",
    "ref": "TXN_DATA_1001"
}

Success Response (200 OK)

{
    "status": "success",
    "Status": "successful",
    "msg": "Transaction Successful"
}

POST

Purchase Airtime (VTU)

https://morevaluedigital.com.ng/api/airtime/

Recharge airtime on MTN, GLO, Airtel, or 9Mobile with vendor discount applied.

Field	Type	Description
`network` *	string	`1`=MTN, `2`=GLO, `3`=9Mobile, `4`=Airtel
`amount` *	number	Recharge amount in Naira (e.g. `100`).
`phone` *	string	The 11-digit recipient phone number.
`ref`	string	Optional unique reference ID.

Request Body (JSON)

{
    "network": "1",
    "amount": 100,
    "phone": "08123456789",
    "ref": "TXN_AIR_1002"
}

Success Response

{
    "status": "success",
    "msg": "Airtime topup successful"
}

POST

Verify Cable TV IUC / SmartCard

https://morevaluedigital.com.ng/api/cabletv/verify/

Validate an IUC or Smartcard number to retrieve the customer name before subscription.

Field	Type	Description
`provider` *	string	`1`=GOTV, `2`=DSTV, `3`=STARTIMES
`iucnumber` *	string	The customer's IUC or SmartCard number.

Request Body (JSON)

{
    "provider": "1",
    "iucnumber": "1234567890"
}

Success Response

{
    "status": "success",
    "customer_name": "JOHN DOE"
}

POST

Purchase Cable TV Subscription

https://morevaluedigital.com.ng/api/cabletv/

Renew or upgrade GOTV, DSTV, or Startimes subscriptions.

Field	Type	Description
`provider` *	string	`1`=GOTV, `2`=DSTV, `3`=STARTIMES
`iucnumber` *	string	Customer IUC / Smartcard number.
`plan` *	string	The Cable Plan ID from your dashboard.
`phone` *	string	Customer phone number.

Request Body (JSON)

{
    "provider": "1",
    "iucnumber": "1234567890",
    "plan": "25",
    "phone": "08123456789",
    "ref": "TXN_CAB_1003"
}

Success Response

{
    "status": "success",
    "msg": "Subscription Successful"
}

POST

Verify Electricity Meter

https://morevaluedigital.com.ng/api/electricity/verify/

Validate prepaid/postpaid DISCO meter numbers to fetch the consumer's registered name.

Field	Type	Description
`provider` *	string	DISCO Provider ID (e.g. `1`=IKEDC, `2`=EKEDC, `6`=IBEDC).
`meternumber` *	string	The meter number to verify.
`metertype` *	string	`prepaid` or `postpaid`

Request Body (JSON)

{
    "provider": "1",
    "meternumber": "01234567890",
    "metertype": "prepaid"
}

Success Response

{
    "status": "success",
    "customer_name": "JANE DOE",
    "address": "Plot 12, Example Estate"
}

POST

Purchase Electricity Token

https://morevaluedigital.com.ng/api/electricity/

Purchase recharge units for any Nigerian electricity distribution company.

Field	Type	Description
`provider` *	string	DISCO Provider ID from dashboard.
`meternumber` *	string	Meter number.
`metertype` *	string	`prepaid` or `postpaid`
`amount` *	number	Amount in Naira.
`phone` *	string	Customer contact phone.

Request Body (JSON)

{
    "provider": "1",
    "meternumber": "01234567890",
    "metertype": "prepaid",
    "amount": 2000,
    "phone": "08123456789",
    "ref": "TXN_ELEC_1004"
}

Success Response

{
    "status": "success",
    "token": "1234-5678-9012-3456-7890",
    "units": "31.4 kWh"
}

POST

Generate Exam Pins

https://morevaluedigital.com.ng/api/exam/

Generate instant e-pins and serial numbers for educational exam result checkers.

Field	Type	Description
`provider` *	string	`1`=WAEC, `2`=NECO, `3`=NABTEB
`quantity` *	number	Number of pins to generate (e.g. `1`).
`ref`	string	Optional unique reference ID.

Request Body (JSON)

{
    "provider": "1",
    "quantity": 1,
    "ref": "TXN_EXAM_1005"
}

Success Response

{
    "status": "success",
    "pins": [
        {
            "serial": "WAC123456789",
            "pin": "987654321012"
        }
    ]
}

POST

Generate Data Pins

https://morevaluedigital.com.ng/api/datapin/

Generate Data Pins (e-pins) that customers can load manually using USSD codes. Perfect for offline printing and sales.

Field	Type	Description
`network` *	string	`1`=MTN, `2`=GLO, `3`=9Mobile, `4`=Airtel
`data_plan` *	string	The Data Pin Plan ID.
`quantity` *	number	Number of pins to generate.
`businessname` *	string	Business name to print on the ticket.
`ref`	string	Optional unique reference ID.

Request Body (JSON)

{
    "network": "1",
    "data_plan": "15",
    "quantity": 1,
    "businessname": "MoreValue",
    "ref": "TXN_DPIN_1006"
}

Success Response

{
    "status": "success",
    "msg": "Data pin generated successfully"
}

POST

Generate Recharge Card Pins

https://morevaluedigital.com.ng/api/rechargepin/

Generate Airtime Recharge Card Pins (e-pins) for offline printing and sales.

Field	Type	Description
`network` *	string	`1`=MTN, `2`=GLO, `3`=9Mobile, `4`=Airtel
`amount` *	number	Denomination amount (e.g. `100`).
`quantity` *	number	Number of pins to generate.
`name_on_card` *	string	Business name to print on the ticket.
`ref`	string	Optional unique reference ID.

Request Body (JSON)

{
    "network": "1",
    "amount": 100,
    "quantity": 5,
    "name_on_card": "MoreValue",
    "ref": "TXN_RPIN_1007"
}

Success Response

{
    "status": "success",
    "msg": "Recharge pin generated successfully"
}

Ready to connect your website or app?

Create a Vendor account now to get your instant API Token and access live wholesale pricing.

Create Vendor Account