IF you haven't registered yet, make sure you do so here:

https://www.reloadly.com/registration

Sending local values refers to the possibility of topping up a phone using the same local currency not affected by any FX. This is called "local connection" and is available for certain countries only.

To check if local connections are available for an operator/country, please login to your user Portal and go to the Pricing tab.

You can determine if an operator supports local values by searching for the operator or country on this tab and selecting local on the first dropdown list.

When local connections exist, then you will see the operators available, the discounts we provide and the possible values you may send listed on the page.

***Please note that in order to send local values, your account currency must be in the destination country currency****

How to send local values with an API Request:

You can send local values when a local connection exists, using this request body and setting useLocalAmount to true:

{
"operatorId": 342,
"useLocalAmount": true,
"amount": 100,
"recipientPhone": {
"countryCode": "NG",
"number": "+2348024113519"
},
"senderPhone": {
"countryCode": "US",
"number": "+13055555555"
}
}

You can learn more about this request on the API documentation:

https://developers.reloadly.com/#topups

https://developers.reloadly.com/api.html#send-topup

To verify if a local connection exists through the API, call this end point to check for a specific operator:

GET :

https://topups.reloadly.com/operators/342

342 in this example is the operator SKU, that can be found on your portal PRICING page, on the first column.

When the operator supports local connections, the parameter supportsLocalAmounts will be true. When the operator does not support local connections, the parameter will be false.

RESPONSE

{

"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": 360,

"currencyCode": "NGN"

},

"logoUrls": [

"https://s3.amazonaws.com/rld-operator/2acbfe97-ef3e-4cce-906f-8681fed03b2d-size-2.png",

"https://s3.amazonaws.com/rld-operator/2acbfe97-ef3e-4cce-906f-8681fed03b2d-size-3.png",

"https://s3.amazonaws.com/rld-operator/2acbfe97-ef3e-4cce-906f-8681fed03b2d-size-1.png"

],

"fixedAmounts": [],

"fixedAmountsDescriptions": {},

"localFixedAmounts": [],

"localFixedAmountsDescriptions": {},

"suggestedAmounts": [

1,

5,

10,

15,

20,

25,

30,

35,

40,

45,

50,

55,

60,

65,

70,

75,

80,

85,

90,

95,

100,

105,

110,

115,

120,

125,

130,

135

],

"suggestedAmountsMap": {},

"promotions": []

}

Let us know if you have any further questions at support@reloadly.com or via the chat box.

Did this answer your question?