airtime api mtn glo Airtel 9mobile Nigeria

Airtime API for MTN, Glo, Airtel and 9Mobile in Nigeria

Connect to MTN, Glo, Airtel and 9Mobile and start sending airtime and data recharges within minutes.
Using Reloadly’s programmable and scalable API, it is now easier than ever to distribute virtual airtime top-ups through Nigeria’s leading mobile operators.

About Nigeria Telecoms

Nigeria makes up the largest mobile market share in Africa, with 199 million subscribers as of March 2020. As of 2020, the telecom sector contributed over 10% to the country’s economy — the second largest on the continent after South Africa — making for an increase from 7.5% just three years ago. 

In Nigeria, mobile operators still use 100% GSM technology for their networks. Nigerians are considered heavy mobile users, and mobile telephony connects more people to the internet than any other technology, making mobile phones the primary platform for creating, distributing and consuming digital content and services in the country.

Today, Nigeria’s mobile market benefits from strong international competition. MTN, a giant telco from South Africa, leads the market, but only barely. In recent years, mobile operators have faced heavy financial pressures due to the nation’s economic woes, which have resulted in large-scale job losses.  

There are four main mobile operators in Nigeria. They are:

  • MTN Nigeria, which has a 36% market share;
  • Glo (Globacom), which has a 26% share;
  • Airtel Nigeria, which has a 24% share; and
  • 9mobile (formerly Etisalat Nigeria), which has a 12% share.
mtn nigeria airtime api
glo nigeria airtime api
airtime api Airtel nigeria
9mobile nigeria airtime api

Airtime API Overview

Reloadly offers an airtime API connection to Nigerian mobile subscribers with an instant prepaid balance top up mechanism and notifications for success or failure. Reloadly also provides attractive discounts on every transaction so you can save or earn profits. 

Airtime top ups are available in Nigerian naira values and for cross-border international mobile top ups as well. Now you can seamlessly decide which pricing pipeline you wish to use and say goodbye to complicated international airtime transactions forever.

bash
php
r
java
"transactionId" : 1 ,
  "recipientPhone" : "50936377111" ,
  "senderPhone": "13059547862",
  "countryCode": "HT",
  "operatorId": 173,
  "requestedAmount": 15,
  "requestedAmountCurrencyCode": "USD",
  "deliveredAmount": 997.2,
  "deliveredAmountCurrencyCode": "HTG",
  "customIdentifier": "transaction by john@example.com" ,
  "transactionDate": "2018-06-26 07:43:36"  
  $ch = curl_init();

  //Decide which one you want to use
  $live    = "https://topups.reloadly.com";
  $testing = "https://topups-sandbox.reloadly.com";

  curl_setopt($ch, CURLOPT_URL, $live); //Using live here
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
  curl_setopt($ch, CURLOPT_HEADER, FALSE);
  curl_setopt($ch, CURLOPT_POST, TRUE);

  curl_setopt($ch, CURLOPT_POSTFIELDS, '{
    "recipientPhone": {
      "countryCode": "HT" ,
      "number": "+50936377111" //(Note the "+509" country dialing code for Haiti)
    },
    "senderPhone": {
      "countryCode": "US",
      "number": "+13059547862" //(Note the "+1" country dialing code for USA)
    }, 
    "operatorId": 173,
    "amount": 15,
    "customIdentifier": "transaction by john@example.com"
 }');

 curl_setopt ($ch, CURLOPT_HTTPHEADER, array(
   "Content-Type: application/json",
   "Accept: application/com.reloadly.topups-v1+json",
   "Authorization: Bearer PUT_YOUR_TOKEN_HERE"
 ));

 $response = curl_exec($ch);
 curl_close ($ch);
 var_dump ($response);
require 'rubygems' if RUBY_VERSION < '1.9'
require 'rest_client'

values = {
  "recipientPhone": {
     "countryCode": "HT",
     "number":  "+50936377111"  //(Note the "+509" country dialing code for Haiti) },
  "senderPhone": {
     "countryCode" : "US" ,
     "number":  "+13059547862" //(Note the "+1" country dialing code for USA)
   },
   "operatorId" : 173,
   "amount" : 15,
   "customIdentifier" : "transaction by john@example.com"
} 

headers = {
   : content_type => 'application/json',
   : accept => 'application/com.reloadly.topups-v1+json' ,
   : authorization => 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ik0wWXpRa'
}

response = RestClient.post 'https://topups.reloadly.com/topups' , values, headers
puts responseResponse   
import javax.ws.rs.client.Client;
import javax.ws.rs.client.ClientBuilder;
import javax.ws.rs.client.Entity;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.MediaType;

Client client = ClientBuilder.newClient();
Entity payload = Entity.json("{
  \"recipientPhone\" : {
    \"countryCode\" :\"HT\",
    \"number\" :\"+50936377111\" //(Note the "+509" country dialing code for Haiti)
  },
  \"senderPhone\" : {
    \"countryCode\" : \"US\",
    \"number\" : \"+13059547862\" //(Note the "+1" country dialing code for USA)
  },
  \"operatorId\" : 173 ,
  \"amount\" :  15,
  \"customIdentifier\" : \"transaction by john@example.com"
}");

Response response = client.target( "https://topups.reloadly.com/topups" )
 .request (MediaType.APPLICATION_JSON_TYPE)
 .header ("Accept", "application/com.reloadly.topups-v1+json" )
 .header ("Authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ik0wWXpRa" )
 .post (payload);

System.out.println ("status: "  +  response. getStatus());
System.out.println ("headers: "  +  response. getHeaders());
System.out.println ("body: " +  response. readEntity( String.class ));   

Integrate in minutes

A few lines of code that scale
with startups to the Fortune 500

  • Extensive API documentation
  • Libraries for popular languages
  • Intuitive, easy-to-use tutorials

Use Cases

Micro-payment solutions

Airtime is one of the most efficient channels for making micro payments to a large group of people in emerging markets. Our platform makes it easy to build a solution like this and earn discounts when doing it.

Remittances

Enable the transfer of cross-border mobile airtime for remittance services. International mobile top ups is a great value add for migrants and expats across the world.

Incentives and Rewards

Airtime rewards can be a great incentive for a mobile subscriber to take part in an activity such as polling, loyalty and rention. Use it to drive up survey response rates, run mass-market advertising campaigns or promote content.

Make your first API call today with Reloadly

Signup for a developer account and connect to our API in minutes