How do I know which operators support local values? How do I send local topups?
Top-up · Local Connections
Skip the FX entirely — send in the recipient's own currency
What a "local connection" is, how to check if an operator supports it, and how to send local values through the Portal or the API.
Available for
Select countries
Key parameter
useLocalAmount
Level
Technical
Sending local values means topping up a phone in the recipient's own local currency, with no FX conversion involved at all. This is called a local connection, and it's only available for certain countries and operators.
In this article
Check for local connections in the Portal
Log in to your Portal and go to Pricing. Then:
- Select Local in the Discount type dropdown.
- Filter by either SKU/Operator Name or Country.
- Select or type your destination in the last field and click Search.
🔍 Nothing appears
That operator/country doesn't support local connections.
✅ Results appear
You'll see the operators, discounts, and the local values you can send.
Important: To send local values through the Portal, your Reloadly account currency must match the destination country's currency. For example, to top up a Nigerian number in NGN, your account must be denominated in NGN. If your account is in a different currency, use the API instead (see Step 2).
Send local values through the API
When a local connection exists for that operator (i.e., supportsLocalAmounts is true — see Step 3), set useLocalAmount to true and provide amount in the destination currency. In the example below, "amount": 100 means 100 NGN:
{
"operatorId": 342,
"useLocalAmount": true,
"amount": 100,
"recipientPhone": {
"countryCode": "NG",
"number": "+2348024113519"
},
"senderPhone": {
"countryCode": "US",
"number": "+13055555555"
}
}
Full API reference: Topups overview · Send Topup endpoint. For authentication setup and sandbox testing, see the Getting Started guide.
Check for local connections through the API
Call this endpoint with a specific operator's SKU — found in the first column of the Portal's Pricing page:
GET
https://topups.reloadly.com/operators/342
Check the supportsLocalAmounts field in the response — true means the operator supports local connections, false means it doesn't:
{
"operatorId": 342,
"name": "Airtel Nigeria",
"bundle": false,
"data": false,
"pin": false,
"supportsLocalAmounts": true,
"denominationType": "RANGE",
"senderCurrencyCode": "USD",
"senderCurrencySymbol": "$",
"destinationCurrencyCode": "NGN",
"destinationCurrencySymbol": "₦",
"commission": 3.0,
"internationalDiscount": 3.0,
"localDiscount": 1.0,
"mostPopularAmount": 15,
"mostPopularLocalAmount": null,
"minAmount": 0.14,
"maxAmount": 138,
"localMinAmount": 50,
"localMaxAmount": 50000.00,
"country": {
"isoName": "NG",
"name": "Nigeria"
},
"fx": {
"rate": 1580,
"currencyCode": "NGN"
},
"fixedAmounts": [],
"localFixedAmounts": [],
"suggestedAmounts": [1, 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, ...],
"promotions": []
}
❓ Frequently asked questions
Do all operators support local connections?
No — only certain countries and operators do. Always check supportsLocalAmounts via the API, or search with Discount type set to Local in the Portal, before assuming it's available.
Can I send local values through the Portal in any account currency?
No — your account currency must match the destination country's currency to send local values through the Portal. Via the API, you can send local values regardless of your account currency — the useLocalAmount flag instructs the API to accept the amount in the destination currency directly.
Where do I find an operator's SKU to check local support?
It's the first column on the Portal's Pricing page — use that same number as the operatorId in your API calls.
Still have questions about local connections?
Let us know and we'll be glad to help.