Developer API Documentation

Scale your business with our lightning-fast VTU & Bill Payment REST API.

Authentication

To access our endpoints, every request must include your api_key. This key acts as your identity and authorization token.

Join our Developer Community

Login or Create an account to view your unique API credentials.

Profile & Wallet

Fetch real-time user profile data including current wallet balance, KYC status, and account level.

GET https://v6.datagifting.com.ng/web/api/profile.php
Parameters
ParameterRequiredDescription
api_keyYesYour account authentication key.
Try it out

Dedicated Virtual Banks

Fetch the list of dedicated virtual bank accounts (Monnify, Paystack, Payvessel, PayHub) assigned to your account for automated funding.

GET https://v6.datagifting.com.ng/web/api/virtual-banks.php
Parameters
ParameterRequiredDescription
api_keyYesYour account authentication key.
Try it out

Share Fund API

Transfer funds between wallets within the same vendor platform.

POST https://v6.datagifting.com.ng/web/api/share-fund.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
userYesRecipient's username
amountYesAmount to transfer
pinYesYour 4-digit Transaction PIN

Automated Funding (Webhooks)

Integrate our automated funding system via webhooks. When a payment is made through any of our supported gateways, our system sends a notification to your server or handles it automatically if you use our virtual accounts.

Security Note

Webhooks are processed using a signature verification system. Ensure you configure your Secret Hash or Public Key in the Admin Panel for each gateway.

Webhook Endpoints
GatewayWebhook URL
Monnify https://v6.datagifting.com.ng/users-monnify.php
Paystack https://v6.datagifting.com.ng/users-paystack.php
Flutterwave https://v6.datagifting.com.ng/web/api/flutterwave_webhook.php
Payvessel https://v6.datagifting.com.ng/users-payvessel.php
PayHub https://v6.datagifting.com.ng/users-payhub.php

Manual Funding Notification

Use this endpoint to notify the admin after a manual bank transfer or deposit. This will create a pending transaction for review.

POST https://v6.datagifting.com.ng/web/api/fund-manual.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
amountYesThe amount deposited.
gatewayNoBank name or payment method used.

Fetch Data Plans

Use this endpoint to dynamically fetch all available networks and their specific plan codes (quantities) for your account level.

GET https://v6.datagifting.com.ng/web/api/data-plans.php
Parameters
ParameterRequiredDescription
api_keyYesYour account authentication key.
Try it out

Airtime VTU

Seamlessly vend airtime for MTN, Airtel, Glo, and 9mobile.

GET https://v6.datagifting.com.ng/web/api/airtime.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
networkYesmtn, airtel, glo, 9mobile
amountYesNumeric value (Minimum 100)
phone_noYesRecipient's 11-digit phone number
Try it out

Data Bundle (Gifting)

Vend all types of data bundles including SME, Gifting, and Corporate Data.

GET https://v6.datagifting.com.ng/web/api/data.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
typeYessme-data, shared-data, cg-data, dd-data
networkYesmtn, airtel, glo, 9mobile
quantityYesPlan Code (obtain from Fetch Data Plans API)
phone_noYesRecipient's 11-digit phone number
Try it out

Cable TV API

Renew subscriptions for DSTV, GOTV, and Startimes.

GET https://v6.datagifting.com.ng/web/api/cable.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
typeYesdstv, gotv, startimes
packageYesPackage Plan Code
iuc_numberYesSmartcard or IUC number
Try it out

Electricity API

Pay electricity bills and receive meter tokens instantly.

GET https://v6.datagifting.com.ng/web/api/electric.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
providerYesDisco name (e.g. ikedc, ekedc, aedc)
typeYesprepaid or postpaid
amountYesMinimum 1000
meter_numberYesCustomer's meter number
Try it out

Exam PIN API

Generate result checker pins for WAEC, NECO, and NABTEB.

GET https://v6.datagifting.com.ng/web/api/exam.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
typeYeswaec, neco, nabteb
quantityYesNumber of pins required
Try it out

Bulk SMS API

Send customized text messages to any Nigerian network with high delivery rates.

POST https://v6.datagifting.com.ng/web/api/sms.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
networkYesRecipient network (mtn, airtel, etc.)
phone_numberYes11-digit phone number
sender_idYesMax 11 characters alphanumeric
messageYesUTF-8 encoded message text
typeYesplain or flash
Try it out

Betting Wallet Funding

Instantly fund customer wallets for all major sports betting platforms.

GET https://v6.datagifting.com.ng/web/api/betting.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
providerYese.g. bet9ja, betking, 1xbet
customer_idYesCustomer's User ID on the platform
amountYesAmount to fund
Try it out

Gift Card API

Purchase and manage gift cards from over 2,000 brands globally.

POST https://v6.datagifting.com.ng/web/api/gift-card.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
actionYeslist_products, purchase, my_cards
product_idNoRequired for purchase
amountNoAmount in USD (Required for purchase)

Virtual Card API (Chimoney)

Issue and fund premium USD Virtual Cards for global payments.

POST https://v6.datagifting.com.ng/web/api/virtual-card.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
actionYeslist_cards, issue, fund, reveal
product_idNoRequired for issue
amount_usdNoRequired for issue (Min $5) or fund
pinNoRequired for reveal

Print Hub (Universal EPIN API)

Generate printable EPINs for Data, Airtime, and other services in bulk.

POST https://v6.datagifting.com.ng/web/api/databundle-card.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key (sent via GET)
networkYesNetwork Name (mtn, airtel, etc.)
data_typeYessme-data, cg-data, airtime, etc.
plan_codeYesThe plan identifier code
quantityYesNumber of pins (1-40)
Try it out

AI Assistant Service

Integrate our powerful, intelligent AI directly into your own websites and applications. The AI can answer VTU queries, help with technical troubleshooting, or serve as a general assistant for your users.

Billing & Cost

Unlike the Mobile App which uses a separate AI Tokens balance, this API endpoint deducts the cost directly from your Main Wallet Balance. The standard cost is ₦2 per successful request.

POST https://v6.datagifting.com.ng/web/api/ai-chat.php
Parameters (JSON)
ParameterRequiredDescription
api_keyYesYour API Key
promptYesThe message or question you want to send to the AI.
Try it out

Mobile APK Integration

Use these endpoints to build a native mobile application (Android/iOS) for your platform. These endpoints support registration, login, and profile management.

Futuristic Mobile Architecture

Our mobile API is designed for **Futuristic UI/UX** layouts. It supports glassmorphism designs, real-time shimmer animations, and biometric security.

1. Registration
POST https://v6.datagifting.com.ng/web/api/register.php

Parameters: user, pass, first, last, email, phone, address.

2. Login
POST https://v6.datagifting.com.ng/web/api/login.php

Parameters: user, pass. Returns api_key and user details.

3. Biometric Verification
POST https://v6.datagifting.com.ng/web/api/biometric.php?action=verify_mobile_login

Used for native mobile app login. Requires username and api_key.

4. Unified Services Fetcher
POST https://v6.datagifting.com.ng/web/api/services.php

Parameters: api_key. Returns all enabled services and their corresponding plan lists for the dashboard.

4. KYC Identity Verification
POST https://v6.datagifting.com.ng/web/api/kyc_submit.php

Used for Face ID Liveness and Govt ID upload. Supports multipart/form-data for file uploads and face_image_data as Base64.

5. Payment Gateway Webhooks

Use these URLs in your gateway provider dashboards. They automatically credit user wallets upon successful payment notifications.

ProviderWebhook URLSecurity Method
Flutterwave https://v6.datagifting.com.ng/web/api/flutterwave_webhook.php HTTP_VERIF_HASH
Paystack https://v6.datagifting.com.ng/users-paystack.php X-Paystack-Signature
Monnify https://v6.datagifting.com.ng/users-monnify.php monnify-signature
PayHub https://v6.datagifting.com.ng/users-payhub.php Secret Hash Verification

BVN Verification

Verify any Bank Verification Number (BVN) and retrieve associated identity information instantly.

POST https://v6.datagifting.com.ng/web/api/bvn-verify.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
bvnYes11-digit Bank Verification Number
Response
FieldDescription
statussuccess / failed
firstnameFirst name on BVN
middlenameMiddle name on BVN
lastnameLast name on BVN
date_of_birthDate of birth
genderMale / Female
phoneRegistered phone number
bank_of_enrolmentBank where BVN was registered
level_of_accountAccount level
fee_chargedAmount deducted from wallet
referenceUnique transaction reference

Requery Transaction

Verify the final status of a transaction using the reference identifier.

GET https://v6.datagifting.com.ng/web/api/requery.php
Parameters
ParameterRequiredDescription
api_keyYesYour API Key
referenceYesThe ref returned in the initial purchase response.
Try it out

Standard Response Codes

All API responses follow this consistent structure to make integration easier.

{
  "status": "success",
  "ref": "TRX_87654321",
  "desc": "Transaction Successful",
  "amount": "500.00",
  "balance_after": "4500.00"
}
Status Definitions
StatusDescription
successThe operation completed successfully.
pendingProcessing. Requery after 30 seconds.
failedOperation failed. Check the desc for details.
Airtime
Data
Home
Cable
Electric