Africa local airtime API

5 Benefits for Africa’s Local Airtime APIs

Rice Omary

Rice Omary

3 min

There’s a new feature in Reloadly’s API that now allows local airtime values across several countries in Africa. With one API, Reloadly allows developers and businesses to top-up local airtime across multiple countries and operators.

This feature allows developers and businesses in their local countries to now use Reloadly’s API. Reloadly is responding to what its customers was asking for. Connecting to local telcos in Africa is a nightmare, therefore Reloadly makes this easy for developers to quickly plug and play. Here’s five key benefits of using local airtime top up APIs.

1.Tax Savings

Using Reloadly airtime for local amounts represents a savings advantage to customers who previously sent top-ups using international providers. In many countries, by using a local provider you might be liable for taxes and or the provider might deduct local taxes from the airtime amounts delivered to the end-user. Reloadly is an international company, therefore we do not deduct taxes from your airtime recharges.

For example, if an end-user sends 20 Nigerian Naira as a top-up and a 1% tax is assessed, the recipient will only receive 19.98 in mobile recharge. 

However, when end-users send top-ups using local amounts governments consider it a “within-country” transaction. This means that taxes are not usually assessed.

2.No more Foreign Exchange fees

In addition, local amounts allow developers or accounts in their local countries to top-up without the hassle of exchange rates. This allows end-users to choose local values and smaller increments of airtime, opening up the possibilities of micro-transactions. With Reloadly, you can access local airtime values across many countries while using one single wallet in your preferred currency and with one API. This is a game-changer across Africa where 98% of the continent depends on prepaid phones.

3. Ability to sell locally in your countries

Unlike international top ups, customers for local top ups expect to receive the exact amount in their local currencies when making an airtime top up. With Rel0adly’s local values pipe, this is no more an issue as your customers will receive the exact local value in their local currency. Local airtime top-ups open possibilities for many new digital channels including banks, ATMs, apps, and websites to sell or to use as a reward mechanism in their local countries.

4. Access local amounts covering 16 different countries in Africa

Reloadly gives you access to 16 different countries across Africa with one API for local top-ups and adding new ones every month. No more hassles to integrate multiple providers and manage different wallets in each country. We have removed all these complications with simple APIs, one wallet and access to multiple countries.

5. Direct with Mobile Operators

Unlike many other providers, Reloadly focuses on establishing direct relationships with the major mobile operators in the region. This relates to better commissions for our customers, a better quality of service and better support.

How to Use Local Amounts for Mobile Recharge Worldwide

mobile recharge worldwide savings

The local amounts feature presents innumerable benefits and it’s very easy to use.

First, you must determine if a mobile operator supports top-ups in local currencies. This can be done by examining the fixed amount field or the range amounts (delineated by the min and max amount fields). If a fixedAmount field’s corresponding localFixedAmounts field is not null, that means the operator supports local currencies. 

Below is a sample response:

{
    "operatorId": 590,
    "name": "ReachOut PIN USA",
    "bundle": false,
    "data": false,
    "pin": true,
    "denominationType": "FIXED",
    "senderCurrencyCode": "EUR",
    "senderCurrencySymbol": "€",
    "destinationCurrencyCode": "USD",
    "destinationCurrencySymbol": "$",
    "commission": 1.0,
    "internationalDiscount": 1.0,
    "localDiscount": 0.0,
    "mostPopularAmount": 18.14,
    "mostPopularLocalAmount": 20.00,
    "minAmount": null,
    "maxAmount": null,
    "localMinAmount": null,
    "localMaxAmount": null,
    "country": {
        "isoName": "US",
        "name": "United States"
    },
    "fx": {
        "rate": 1.10278,
        "currencyCode": "USD"
    },
    "logoUrls": [
        "https://s3.amazonaws.com/rld-operator/76827a06-2b87-4408-877c-c454e1574bc4-size-1.png",     "https://s3.amazonaws.com/rld-operator/76827a06-2b87-4408-877c-c454e1574bc4-size-2.png", "https://s3.amazonaws.com/rld-operator/76827a06-2b87-4408-877c-c454e1574bc4-size-3.png"
    ],
    "fixedAmounts": [
        4.53,
        9.07,
        18.14,
        24.03,
        27.20,
        45.34
    ],
    "fixedAmountsDescriptions": {},
    "localFixedAmounts": [
        5.00,
        10.00,
        20.00,
        26.50,
        30.00,
        50.00
    ],
    "localFixedAmountsDescriptions": {},
    "suggestedAmounts": [],
    "suggestedAmountsMap": {},
    "promotions": []
}

Once you determine if an operator supports local amounts, invoke the feature by calling the new bit field UseLocalAmount. Set this field to true when sending the POST. For more details on this, check out the transaction endpoint video.

Note that if you try to use local amounts and the operator does not support this, you will receive an error code in the response.   

For more on how to use Reloadly’s API, including the local amounts feature, see the video playlist below.  Want to get started, get your Free API Key today!

This might also interest you:

Content by developers to developers.

Subscribe to The Monthly Reload for Developers and start receiving all the developers’ updates.

The Monthly Reload: the newsletter for you

Subscribe to our Newsletter and don’t miss any news about our industry and products.

It’s time to build, make your first API call today