How do I know which operators support local values? How do I send local topups?

How do I know which operators support local values? How do I send local topups? Sending local values through the API and Portal when available samuel nwadilobi nnabugwu

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.

Select Local in the Discount type dropdown list.

Filter by either SKU/Operator Name or Country.

Select or type your destination in the last field and click Search.

If nothing appears, this means that the operator/country selected does not support local connections.

When local connections exist, 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 when you are using the Portal****

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?