Developer API Documentation
Scale your business with our lightning-fast VTU & Bill Payment REST API.
Profile & Wallet
Fetch real-time user profile data including current wallet balance, KYC status, and account level.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your 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.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your account authentication key. |
Try it out
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
| Gateway | Webhook 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.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
amount | Yes | The amount deposited. |
gateway | No | Bank 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.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your account authentication key. |
Try it out
Airtime VTU
Seamlessly vend airtime for MTN, Airtel, Glo, and 9mobile.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
network | Yes | mtn, airtel, glo, 9mobile |
amount | Yes | Numeric value (Minimum 100) |
phone_no | Yes | Recipient's 11-digit phone number |
Try it out
Data Bundle (Gifting)
Vend all types of data bundles including SME, Gifting, and Corporate Data.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
type | Yes | sme-data, shared-data, cg-data, dd-data |
network | Yes | mtn, airtel, glo, 9mobile |
quantity | Yes | Plan Code (obtain from Fetch Data Plans API) |
phone_no | Yes | Recipient's 11-digit phone number |
Try it out
Cable TV API
Renew subscriptions for DSTV, GOTV, and Startimes.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
type | Yes | dstv, gotv, startimes |
package | Yes | Package Plan Code |
iuc_number | Yes | Smartcard or IUC number |
Try it out
Electricity API
Pay electricity bills and receive meter tokens instantly.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
provider | Yes | Disco name (e.g. ikedc, ekedc, aedc) |
type | Yes | prepaid or postpaid |
amount | Yes | Minimum 1000 |
meter_number | Yes | Customer's meter number |
Try it out
Exam PIN API
Generate result checker pins for WAEC, NECO, and NABTEB.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
type | Yes | waec, neco, nabteb |
quantity | Yes | Number of pins required |
Try it out
Bulk SMS API
Send customized text messages to any Nigerian network with high delivery rates.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
network | Yes | Recipient network (mtn, airtel, etc.) |
phone_number | Yes | 11-digit phone number |
sender_id | Yes | Max 11 characters alphanumeric |
message | Yes | UTF-8 encoded message text |
type | Yes | plain or flash |
Try it out
Betting Wallet Funding
Instantly fund customer wallets for all major sports betting platforms.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
provider | Yes | e.g. bet9ja, betking, 1xbet |
customer_id | Yes | Customer's User ID on the platform |
amount | Yes | Amount to fund |
Try it out
Gift Card API
Purchase and manage gift cards from over 2,000 brands globally.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
action | Yes | list_products, purchase, my_cards |
product_id | No | Required for purchase |
amount | No | Amount in USD (Required for purchase) |
Virtual Card API (Chimoney)
Issue and fund premium USD Virtual Cards for global payments.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
action | Yes | list_cards, issue, fund, reveal |
product_id | No | Required for issue |
amount_usd | No | Required for issue (Min $5) or fund |
pin | No | Required for reveal |
Print Hub (Universal EPIN API)
Generate printable EPINs for Data, Airtime, and other services in bulk.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key (sent via GET) |
network | Yes | Network Name (mtn, airtel, etc.) |
data_type | Yes | sme-data, cg-data, airtime, etc. |
plan_code | Yes | The plan identifier code |
quantity | Yes | Number 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.
Parameters (JSON)
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
prompt | Yes | The 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.
- Full Mobile API Spec (v2.0)
- Android Studio Local Setup Guide
- New: Professional Kotlin Source Code (DGV6.7-Futuristic) is now available in
/DG6-Androidfor GitHub compilation.
1. Registration
Parameters: user, pass, first, last, email, phone, address.
2. Login
Parameters: user, pass. Returns api_key and user details.
3. Biometric Verification
Used for native mobile app login. Requires username and api_key.
4. Unified Services Fetcher
Parameters: api_key. Returns all enabled services and their corresponding plan lists for the dashboard.
4. KYC Identity Verification
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.
| Provider | Webhook URL | Security 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.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
bvn | Yes | 11-digit Bank Verification Number |
Response
| Field | Description |
|---|---|
status | success / failed |
firstname | First name on BVN |
middlename | Middle name on BVN |
lastname | Last name on BVN |
date_of_birth | Date of birth |
gender | Male / Female |
phone | Registered phone number |
bank_of_enrolment | Bank where BVN was registered |
level_of_account | Account level |
fee_charged | Amount deducted from wallet |
reference | Unique transaction reference |
Requery Transaction
Verify the final status of a transaction using the reference identifier.
Parameters
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your API Key |
reference | Yes | The 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
| Status | Description |
|---|---|
| success | The operation completed successfully. |
| pending | Processing. Requery after 30 seconds. |
| failed | Operation failed. Check the desc for details. |
