Developers API

Overview

Mobilevtu.com Topup API is designed for developers to easily and seamlesly integrate mobile data and airtime topup functionality on any application using any software programing technology or development platform

The API allow you to programmatically interact with Mobilevtu.com services such as

  • Mobile Airtime recharge
  • Mobile Data subscription
  • Transaction Status Query
  • Transaction Search
  • Balance Query
  • Our API attempts to conform to the RESTful design principles. You interact with the resources exposed through the API by accessing resource collection and element URIs using the HTTP POST.

    You will likely need access to a web developer or programmer (if you’re not one) to get the most use out of Mobilevtu.com API.

    Access to Mobilevtu.com API is Freely available to all Mobilevtu.com customers

    Requirements

    In order to interact with Mobilevtu.com Topup API, you must fulfil all of the following requirements;

  • Have an Active Customer account with Mobilevtu.com
  • Enabled API Access on your Mobilevtu.com account
  • Once you have setup an account, simply Login to Mobilevtu.com Portal, navigate to Developers from the main menu to enable API access on your account and access your API credentials

    URL

    Mobilevtu.com API URL is made up of the base URL, the resource URI and an API key. A complete API URL will look like this; https://api.mobilevtu.com/v1/‹API Key›/‹resource URI›

    Authentication

    All requests to Mobilevtu.com API requires authentication. Our API Authentication is implemented as HTTP Header Authentication over TLS (HTTPS).

    To authenticate your request, you need to pass the following parameters as part of your HTTP request headers;

    Api-Token: Your account API token
    Request-Id: A unique identifier of your current request (must be unique for each request)

    Sample Authentication using CURL

           curl --request POST \
             --url 'https://api.mobilevtu.com/v1/GGiet8506Rlglhglbfj7/topup' \
             --header 'Api-Token: 33tdg37egsbxyube' \
             --header 'content-type: application/x-www-form-urlencoded'
                        

    Request Method

    Mobilevtu.com API accept only HTTP POST requests. Any other request method will not be recognized by our API

    Response Format

    Mobilevtu.com API response (success or error) is returned in JSON data. Response codes are sent via the normal HTTP Response Code,

    Sample Success Response

        {
            "request": "check_balance",
            "status":"success",
            "data":{
                    "balance": "123",
                    "currency": "NGN"
                  }
        }           	
                        

    Sample Error Response

        {
            "request":"fetch_data_plans",
            "status":"error",
            "message":"API access not not allowed on this account"
        }
                        

    POST - Check Wallet Balance /check_balance

    This API allows you to check your Mobilevtu.com current wallet balance.

    Request Parameters

    Parameter Description
    currency Optional Currency to return ballance in (Default value is NGN)

    Sample Request using CURL

                       curl --request POST \
                         --url 'https://api.mobilevtu.com/v1/GGiet8506Rlglhglbfj7/check_balance' \
                         --header 'Api-Token: 33tdg37egsbxyube' \
                         --header 'content-type: application/x-www-form-urlencoded'
                         --data 'currency=NGN'
                                    

    Sample Success Response

                    {
                        "request": "check_balance",
                        "status":"success",
                        "data":[
                                {"balance": "123",
                                "currency": "NGN"
                              }
                        ]
                    }           	
                                    

    POST - Fetch Transaction Status /transaction_status

    This API allows you to check the network status of a transaction at Mobilevtu.com using the transaction reference.

    Request Parameters

    Parameter Description
    transaction_id Required The full transaction reference to query status

    Sample Request using CURL

                       curl --request POST \
                         --url 'https://api.mobilevtu.com/v1/GGiet8506Rlglhglbfj7/transaction_status' \
                         --header 'Api-Token: 33tdg37egsbxyube' \
                         --header 'content-type: application/x-www-form-urlencoded'
                         --data 'transaction_id=DJTIG85859H9H5DUYTWFB7'
                                    

    Sample Success Response

                    {
                        "request": "transaction_status",
                        "status":"success",
                        "data":[
                                {"transaction_id": "DJTIG85859H9H5DUYTWFB7",
                                "transaction_status": "ORDER_COMPLETED"
                              }
                        ]
                    }           	
                                    

    POST - Fetch Data Plan List /fetch_data_plans

    This API allows you to fetch the list of supported Mobilevtu.com data plans for a specific operator using the operator ID.

    Request Parameters

    Parameter Description
    operator Required The unique identifier for the operator. This is Case Sensitive (MTN, Airtel, 9mobile or Glo)

    Sample Request using CURL

                       curl --request POST \
                         --url 'https://api.mobilevtu.com/v1/GGiet8506Rlglhglbfj7/fetch_data_plans' \
                         --header 'Api-Token: 33tdg37egsbxyube' \
                         --header 'content-type: application/x-www-form-urlencoded'
                         --data 'operator=MTN'
                                    

    Sample Success Response

                    {
                        "request": "fetch_data_plans",
                        "status":"success",
                        "data":[
                                {"plan_id": "1000",
                                "label": "1GB",
                                "operator": "MTN",
                                "validity": "30",
                                "price": "600",
                                "currency": "NGN"
                              },
                              {"plan_id": "2000",
                                "label": "2GB",
                                "operator": "MTN",
                                "validity": "30",
                                "price": "1100",
                                "currency": "NGN"
                              }
                        ]
                    }           	
                                    

    POST - Topup /topup

    This API allows you to initiate new airtime or data topup on Mobilevtu.com. The topup will be charged from your wallet balance

    Request Parameters

    Parameter Description
    operator Required The unique operator identifier for the recipient number (MTN, 9mobile, Glo or Airtel)
    type Required The toup transaction type (airtime or data)
    value Required This will be the correct Data Plan ID for data topup or Airtime Amount for airtime topup
    phone Required This is the mobile phone number to topup (e.g. 08031234567 or 2348031234567)

    Sample Request using CURL

                       curl --request POST \
                         --url 'https://api.mobilevtu.com/v1/GGiet8506Rlglhglbfj7/topup' \
                         --header 'Api-Token: 33tdg37egsbxyube' \
                         --header 'content-type: application/x-www-form-urlencoded'
                         --data 'operator=MTN&type=airtime&value=1000&phone=08031234567'
                                    

    Sample Success Response

                    {
                        "request": "topup",
                        "status":"success",
                        "data":[
                                {"transaction_id": "DJTIG85859H9H5DUYTWFB7",
                                "transaction_status": "completed"
                              }
                        ]
                    }           	
                                    

    POST - Fetch All Transaction /list_transactions

    This API allows you to fetch all transaction on your Mobilevtu.com wallet.

    Request Parameters

    Parameter Description
    none

    Sample Request using CURL

                       curl --request POST \
                         --url 'https://api.mobilevtu.com/v1/GGiet8506Rlglhglbfj7/list_transactions' \
                         --header 'Api-Token: 33tdg37egsbxyube' \
                         --header 'content-type: application/x-www-form-urlencoded'
                         --data 'limit=0'
                                    

    Sample Success Response

                    {
                        "request": "list_transactions",
                        "status":"success",
                        "data":[
                                {"transaction_id": "TT3036HYTIFJUY82RT",
                                "description": "1GB MTN Data",
                                "datetime": "2020-03-30 19:16:42",
                                "phone": "2348031234567",
                                "operator": "MTN",
                                "status": "completed"
                              },
                              {"transaction_id": "2GH6855RE996W000TR",
                                "description": "2000 Glo Airtime",
                                "datetime": "2020-03-30 19:16:42",
                                "phone": "2345098765432",
                                "operator": "Glo",
                                "status": "failed"
                              }
                        ]
                    }          
                                    

    Mobilevtu.com.ng Web Portal

    Start Using Mobilevtu.com API

    Create a Free account with us now and enjoy access to all our top-up e-Wallet and API

    Register now Already Have an Account



    Sign-Up

    Mobilevtu.com

    Mobilevtu.com offers mobile airtime and data top-up packages at wholesale price.

    Contact us

    • Ynet Interactive Ltd
      Ground floor, Hatlab Place, Sokode Crescent
      Wuse Zone 5, Abuja. Nigeria.
    • +234-(0)-7088538551
    • help@mobilevtu.com.ng
    • 8:30am - 5:30pm (Work days)
    Buy cheap data online, Buy MTN airtime, buy etisalat data, buy etisalat airtime, but glo data, buy glo airtime, buy airtel data, buy airtel airtime, cheap airtime, buy data plan cheap online, cheap internet data plans online, top up api, recharge api, online top-up api, online recharge card reseller, top-up reseller api, vtu reseller online, vtu online, top-up website, mobile data api, nigerian top-up api, online recharge platform, mobile top-up api, recharge online, buy data online, buy airtime online
    Top