{"id":2594,"date":"2022-03-07T16:55:33","date_gmt":"2022-03-07T16:55:33","guid":{"rendered":"https:\/\/www.reloadly.com\/blog\/?p=2594"},"modified":"2022-03-07T09:55:54","modified_gmt":"2022-03-07T09:55:54","slug":"specify-non-usd-sending-top-ups","status":"publish","type":"post","link":"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/","title":{"rendered":"How to specify a Non-USD currency when sending top-ups"},"content":{"rendered":"<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_46 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"ez-toc-toggle-icon-1\"><label for=\"item-69d2cebc53218\" aria-label=\"Table of Content\"><span style=\"display: flex;align-items: center;width: 35px;height: 30px;justify-content: center;direction:ltr;\"><svg style=\"fill: #000000;color:#000000\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #000000;color:#000000\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/label><input  type=\"checkbox\" id=\"item-69d2cebc53218\"><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 eztoc-visibility-hide-by-default' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#How_does_currency_conversion_work_in_Reloadlys_TopUps\" title=\"How does currency conversion work in Reloadly&#8217;s TopUps\">How does currency conversion work in Reloadly&#8217;s TopUps<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#Specifiying_the_currency_when_sending_a_request\" title=\"Specifiying the currency when sending a request\">Specifiying the currency when sending a request<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#Getting_the_exchange_rate_applicable_to_a_mobile_Operator\" title=\"Getting the exchange rate applicable to a mobile Operator\">Getting the exchange rate applicable to a mobile Operator<\/a><\/li><\/ul><\/nav><\/div>\n\n<p>Your wallet contents are expressed in your local currency and, unless you specify differently, the quantity you specify for the topup will be used directly to deduct from your balance.<\/p>\n\n\n\n<p>For topups where both the sender and recipient use the same currency (Local topups being the most obvious case) this is fine but, in general, when sending international TopUps a currency conversion will need to take place.<\/p>\n\n\n\n<p>Don&#8217;t worry, Reloadly has you covered.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"How_does_currency_conversion_work_in_Reloadlys_TopUps\"><\/span>How does currency conversion work in Reloadly&#8217;s TopUps<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>In case your balance is expressed in a currency different to the one of the receiving party you have the option of asking Reloadly to make the conversion.<\/p>\n\n\n\n<p>For this Reloadly will use an exchange rate specific to the operator you&#8217;re sending credit to.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Specifiying_the_currency_when_sending_a_request\"><\/span>Specifiying the currency when sending a request<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>Let&#8217;s say you live in the US and you want to make a topup for a phone in Colombia and you want to use Colombian Peso to express the amount to be sent to the recipient.<\/p>\n\n\n\n<p>Let me illustrate this with an example to make things clearer.<\/p>\n\n\n\n<p>You want to make a COP 20,000 topup for <code>+57 301 4264205<\/code>. <\/p>\n\n\n\n<p>The sequence would be:<\/p>\n\n\n\n<ol><li><a rel=\"noreferrer noopener\" href=\"https:\/\/docs.reloadly.com\/airtime\/quickstart#get-your-access-token\" target=\"_blank\">Get an authentication token<\/a><\/li><li><a rel=\"noreferrer noopener\" href=\"https:\/\/www.reloadly.com\/blog\/how-to-reloadly-automatically-detect-operator-id\/\" target=\"_blank\">Get the operator Id<\/a><\/li><li><a rel=\"noreferrer noopener\" href=\"https:\/\/docs.reloadly.com\/airtime\/top-ups\/top-up\" target=\"_blank\">Make the topup request<\/a><\/li><\/ol>\n\n\n\n<p>I&#8217;ll assume you know how to perform steps 1 and 2 (If not, just follow the appropriate links) and show you the details of step 3.<\/p>\n\n\n\n<p>Since you prefer the recipient to be credited a specific number in their own currency, you have to inform Reloadly about that by slightly changing the request you&#8217;d usually send.<\/p>\n\n\n\n<p>Simply use the <code>useLocalAmount<\/code> parameter. Like this:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">curl --location --request POST https:\/\/topups.reloadly.com\/topups --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' --header 'Accept: application\/com.reloadly.topups-v1+json' --header 'Content-Type: application\/json' --data-raw '{\n                \"operatorId\":\"92\",\n                \"amount\":\"20000\",\n\t\t    \"useLocalAmount\": true,\n                \"recipientPhone\": {\n                        \"countryCode\": \"CO\",\n                        \"number\": \"573014264205\"\n                }\n        }<\/pre>\n\n\n\n<p>Which will produce an output similar to:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"transactionId\": 27879,\n  \"status\": \"SUCCESSFUL\",\n  \"operatorTransactionId\": null,\n  \"customIdentifier\": null,\n  \"recipientPhone\": \"573014264205\",\n  \"recipientEmail\": null,\n  \"senderPhone\": null,\n  \"countryCode\": \"CO\",\n  \"operatorId\": 92,\n  \"operatorName\": \"Tigo Colombia\",\n  \"discount\": 0,\n  \"discountCurrencyCode\": \"EUR\",\n  \"requestedAmount\": 20000,\n  \"requestedAmountCurrencyCode\": \"COP\",\n  \"deliveredAmount\": 20000,\n  \"deliveredAmountCurrencyCode\": \"COP\",\n  \"transactionDate\": \"2022-03-02 11:06:23\",\n  \"pinDetail\": null,\n  \"balanceInfo\": {\n    \"oldBalance\": 766.814,\n    \"newBalance\": 755.85748,\n    \"currencyCode\": \"USD\",\n    \"currencyName\": \"US Dollar\",\n    \"updatedAt\": \"2022-03-02 16:06:23\"\n  }\n}<\/pre>\n\n\n\n<p>If you look at the bottom (<code>balanceInfo<\/code>) you&#8217;ll notice how the balance got affected after this transaction:<\/p>\n\n\n\n<p>Before sending the top-up it was USD 766.814 and after it is USD 755.85748.<\/p>\n\n\n\n<p>This means that the exchange rate for this particular operator is 1 USD = COP 1,825.38 (10.95652 USD = 20,000 COP). <\/p>\n\n\n\n<p><em><span style=\"text-decoration: underline;\">Note<\/span>: bear in mind that exchange rates are fluctuant so the exact<\/em> <em>numbers you&#8217;ll get when running this example might not be a perfect match for what you&#8217;re reading here but doesn&#8217;t mean you&#8217;re doing anything wrong<\/em>. <\/p>\n\n\n\n<p>There are times where you may want to know how many pesos the recipient will get for every USD deducted from your wallet before carrying the operation out.<\/p>\n\n\n\n<p>To find that out you can use the <a href=\"https:\/\/docs.reloadly.com\/airtime\/fx-rates\/fetch-fx-rate-by-operator-id\" target=\"_blank\" rel=\"noreferrer noopener\">Fetch FX Rate by Operator Id endpoint<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Getting_the_exchange_rate_applicable_to_a_mobile_Operator\"><\/span>Getting the exchange rate applicable to a mobile Operator<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>What you&#8217;ll want to do is issue a request such as:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">curl --location --request POST https:\/\/topups.reloadly.com\/operators\/fx-rate --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' --header 'Accept: application\/com.reloadly.topups-v1+json' --header 'Content-Type: application\/json' --data-raw '{\n        \"operatorId\":\"92\",\n                \"amount\":\"10\"\n        }'<\/pre>\n\n\n\n<p>Which will produce an output similar to:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"id\": 92,\n  \"name\": \"Tigo Colombia\",\n  \"fxRate\": 18,2533.8,\n  \"currencyCode\": \"COP\"\n}<\/pre>\n\n\n\n<p>Which means when you send 10 USD to a phone operated by Tigo Colombia (Operator with ID 92), the recipient&#8217;s phone will be credited with 18,2533.8 Colombian Pesos.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>When you need to send topups internationally, a currency exchange need to be performed. Reloadly can do it for you&#8230;<\/p>\n","protected":false},"author":22,"featured_media":2599,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[274],"tags":[346,347,14],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v15.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How to specify a Non-USD currency when sending top-ups - Reloadly<\/title>\n<meta name=\"description\" content=\"Do you want to send topups using the recipient&#039;s local currency? Learn how to do that using Reloadly&#039;s API here.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to specify a Non-USD currency when sending top-ups - Reloadly\" \/>\n<meta property=\"og:description\" content=\"Do you want to send topups using the recipient&#039;s local currency? Learn how to do that using Reloadly&#039;s API here.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/\" \/>\n<meta property=\"og:site_name\" content=\"Reloadly\" \/>\n<meta property=\"article:published_time\" content=\"2022-03-07T16:55:33+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-03-07T09:55:54+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/blog.reloadly.com\/blog\/wp-content\/uploads\/2022\/03\/blog_image45-01.png\" \/>\n\t<meta property=\"og:image:width\" content=\"641\" \/>\n\t<meta property=\"og:image:height\" content=\"334\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\">\n\t<meta name=\"twitter:data1\" content=\"3 minutes\">\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#organization\",\"name\":\"Reloadly\",\"url\":\"https:\/\/www.reloadly.com\/blog\/\",\"sameAs\":[],\"logo\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#logo\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/blog.reloadly.com\/blog\/wp-content\/uploads\/2020\/11\/logo-1.svg\",\"width\":100,\"height\":100,\"caption\":\"Reloadly\"},\"image\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#logo\"}},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#website\",\"url\":\"https:\/\/www.reloadly.com\/blog\/\",\"name\":\"Reloadly\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/www.reloadly.com\/blog\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/blog.reloadly.com\/blog\/wp-content\/uploads\/2022\/03\/blog_image45-01.png\",\"width\":641,\"height\":334},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#webpage\",\"url\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/\",\"name\":\"How to specify a Non-USD currency when sending top-ups - Reloadly\",\"isPartOf\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#primaryimage\"},\"datePublished\":\"2022-03-07T16:55:33+00:00\",\"dateModified\":\"2022-03-07T09:55:54+00:00\",\"description\":\"Do you want to send topups using the recipient's local currency? Learn how to do that using Reloadly's API here.\",\"breadcrumb\":{\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/\",\"url\":\"https:\/\/www.reloadly.com\/blog\/\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"position\":2,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/\",\"url\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/\",\"name\":\"How to specify a Non-USD currency when sending top-ups\"}}]},{\"@type\":\"Article\",\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#webpage\"},\"author\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#\/schema\/person\/b7f57cdec858524713a40069354fc55b\"},\"headline\":\"How to specify a Non-USD currency when sending top-ups\",\"datePublished\":\"2022-03-07T16:55:33+00:00\",\"dateModified\":\"2022-03-07T09:55:54+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#webpage\"},\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#primaryimage\"},\"keywords\":\"exchange rate,local currency,top up api\",\"articleSection\":\"Developer Blog\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/blog.reloadly.com\/blog\/specify-non-usd-sending-top-ups\/#respond\"]}]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#\/schema\/person\/b7f57cdec858524713a40069354fc55b\",\"name\":\"Mauro Chojrin\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#personlogo\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/2e0c52b5f88c4911eeb351e93b0dab9a?s=96&d=mm&r=g\",\"caption\":\"Mauro Chojrin\"},\"url\":\"https:\/\/blog.reloadly.com\/blog\/author\/mauro-chojrin\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","authors":[{"term_id":361,"user_id":22,"is_guest":0,"slug":"mauro-chojrin","display_name":"Mauro Chojrin"}],"_links":{"self":[{"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/posts\/2594"}],"collection":[{"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/comments?post=2594"}],"version-history":[{"count":4,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/posts\/2594\/revisions"}],"predecessor-version":[{"id":2600,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/posts\/2594\/revisions\/2600"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/media\/2599"}],"wp:attachment":[{"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/media?parent=2594"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/categories?post=2594"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/tags?post=2594"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}