{"_id":"5632a5eb49e16d0d001224ab","__v":0,"user":"55b932ba8fd1a02b00f496c8","version":{"_id":"5632a5e549e16d0d00122443","__v":6,"project":"55b933b3146ef121002158d3","createdAt":"2015-10-29T23:04:05.701Z","releaseDate":"2015-10-29T23:04:05.701Z","categories":["5632a5e749e16d0d00122444","5632a5e749e16d0d00122445","5632a5e749e16d0d00122446","5632a5e749e16d0d00122447","5632a5e749e16d0d00122448","5632a5e749e16d0d00122449","5632a5e749e16d0d0012244a","5632a5e749e16d0d0012244b","5632a5e749e16d0d0012244c","5632a5e749e16d0d0012244d","5632a5e749e16d0d0012244e","5632a5e749e16d0d0012244f","5632a5e749e16d0d00122450","5632b179df556c0d00cd095b","564e13053b2b4a19000cd69b","59caa9df65accc001a489c95","59cab50965accc001a489d28","59cadd464ab7b70024378e74"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"category":{"_id":"5632a5e749e16d0d0012244c","project":"55b933b3146ef121002158d3","version":"5632a5e549e16d0d00122443","__v":1,"pages":["5632a5eb49e16d0d001224a9","5632a5eb49e16d0d001224aa","5632a5eb49e16d0d001224ab","5632a5eb49e16d0d001224ac","5632a5eb49e16d0d001224ad","5632a5eb49e16d0d001224ae","5632a5eb49e16d0d001224af","5632a5eb49e16d0d001224b0","5632a5eb49e16d0d001224b1","5632a5eb49e16d0d001224b2"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-04T17:33:48.347Z","from_sync":false,"order":11,"slug":"general-merchant-methods","title":"General Merchant Methods"},"githubsync":"","project":"55b933b3146ef121002158d3","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-04T17:47:32.195Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"Find currency conversion rate for a transaction amount.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Description\"\n}\n[/block]\nThis method allows you to determine the rate of conversion for different currencies in multi-currency transactions. A merchant account must have support for specific types of currency before it will be able to run multi-currency transactions.\nTo determine if a currency is supported by a merchant account, use either the [getSupportedCurrencies](/docs/getsupportedcurrencies) or the [getAccountDetails](/docs/getaccountdetails) method.\nEach currency type is assigned a three digit numeric code (ie: USD=840, Japanese yen=392). You must enter the three digit code for both the original currency and the converted currency in a conversion. The Currency Code list provides all of the three digit codes and their corresponding currencies for international currency conversion.\nIf you would like to add support for multi-currency transactions to a merchant account please contact the merchant's service provider or customer service.\nSee also [bulkCurrencyConversion](/docs/bulkcurrencyconversion), [getSupportedCurrencies](/docs/getsupportedcurrencies), [getAccountDetails](/docs/getaccountdetails)\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Syntax\"\n}\n[/block]\n[CurrencyConversion](/docs/currencyconversion-1) **currencyConversion** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer FromCurrency, integer ToCurrency, double Amount )\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Arguments\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Type\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"[ueSecurityToken](/docs/uesecuritytoken)\",\n    \"0-1\": \"Token\",\n    \"0-2\": \"Merchant security token: used to identify merchant and validate transaction.\",\n    \"1-0\": \"string\",\n    \"1-1\": \"FromCurrency\",\n    \"1-2\": \"Currency code funds will be converted from.\",\n    \"2-0\": \"string\",\n    \"2-1\": \"ToCurrency\",\n    \"2-2\": \"Currency code funds will be converted to.\",\n    \"3-0\": \"double\",\n    \"3-1\": \"Amount\",\n    \"3-2\": \"Amount of currency to be converted.\"\n  },\n  \"cols\": 3,\n  \"rows\": 4\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Return Value\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"[CurrencyConversion](/docs/currencyconversion-1)\",\n    \"0-1\": \"Returns the rate of conversion and the amount of the converted currency.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Examples\"\n}\n[/block]\n## PHP \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?php\\n// for directions on how to set up the\\n// WSDL link and create \\\"$mctoken\\\" and \\\"$client,\\\"\\n// see: http://wiki.eBizCharge.com/developer/soap/howto\\ntry {\\n  $ToCurrency='978';\\n  $FromCurrency='840';\\n  $Amount=50;    \\n  $res=$client->currencyConversion($mctoken, $FromCurrency, $ToCurrency, $Amount);\\n         print_r($res);\\n  $this->assertEquals($res->FromCurrency, $FromCurrency);\\n  $this->assertEquals($res->Currency, $ToCurrency);\\n  $this->assertTrue($res->Rate > 0);\\n  $this->assertTrue($res->Amount > 0);\\n} catch (SoapFault $e) {\\n    echo $client->__getLastRequest();\\n    echo $client->__getLastResponse();\\n    die('Currency conversion failed : '.$e->getMessage());\\n}\\n?>\",\n      \"language\": \"php\"\n    }\n  ]\n}\n[/block]\n## Visual Basic (.Net) \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Dim from As String\\n       Dim convert As String\\n       Dim amount As Double\\n       from = \\\"036\\\"\\n       convert = \\\"826\\\"\\n       amount = 50\\n       Dim response As eBizCharge.CurrencyConversion = New eBizCharge.CurrencyConversion\\n       response = client.currencyConversion(token, from, convert, amount)\\n       MsgBox(response.Amount)\",\n      \"language\": \"c\"\n    }\n  ]\n}\n[/block]\n## C Sharp (.Net)\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"string from = \\\"840\\\";\\n           string to = \\\"978\\\";\\n           int amount = 50;\\n           eBizCharge.CurrencyConversion response = new eBizCharge.CurrencyConversion();\\n           try\\n           {\\n               response = client.currencyConversion(token, from, to, amount);\\n               MessageBox.Show(string.Concat(response.Amount));\\n           }\\n           catch (Exception err)\\n           {\\n               MessageBox.Show(err.Message);\\n           }\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"currencyconversion","type":"basic","title":"currencyConversion"}

currencyConversion


Find currency conversion rate for a transaction amount. [block:api-header] { "type": "basic", "title": "Description" } [/block] This method allows you to determine the rate of conversion for different currencies in multi-currency transactions. A merchant account must have support for specific types of currency before it will be able to run multi-currency transactions. To determine if a currency is supported by a merchant account, use either the [getSupportedCurrencies](/docs/getsupportedcurrencies) or the [getAccountDetails](/docs/getaccountdetails) method. Each currency type is assigned a three digit numeric code (ie: USD=840, Japanese yen=392). You must enter the three digit code for both the original currency and the converted currency in a conversion. The Currency Code list provides all of the three digit codes and their corresponding currencies for international currency conversion. If you would like to add support for multi-currency transactions to a merchant account please contact the merchant's service provider or customer service. See also [bulkCurrencyConversion](/docs/bulkcurrencyconversion), [getSupportedCurrencies](/docs/getsupportedcurrencies), [getAccountDetails](/docs/getaccountdetails) [block:api-header] { "type": "basic", "title": "Syntax" } [/block] [CurrencyConversion](/docs/currencyconversion-1) **currencyConversion** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer FromCurrency, integer ToCurrency, double Amount ) [block:api-header] { "type": "basic", "title": "Arguments" } [/block] [block:parameters] { "data": { "h-0": "Type", "h-1": "Name", "h-2": "Description", "0-0": "[ueSecurityToken](/docs/uesecuritytoken)", "0-1": "Token", "0-2": "Merchant security token: used to identify merchant and validate transaction.", "1-0": "string", "1-1": "FromCurrency", "1-2": "Currency code funds will be converted from.", "2-0": "string", "2-1": "ToCurrency", "2-2": "Currency code funds will be converted to.", "3-0": "double", "3-1": "Amount", "3-2": "Amount of currency to be converted." }, "cols": 3, "rows": 4 } [/block] [block:api-header] { "type": "basic", "title": "Return Value" } [/block] [block:parameters] { "data": { "0-0": "[CurrencyConversion](/docs/currencyconversion-1)", "0-1": "Returns the rate of conversion and the amount of the converted currency." }, "cols": 2, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] ## PHP [block:code] { "codes": [ { "code": "<?php\n// for directions on how to set up the\n// WSDL link and create \"$mctoken\" and \"$client,\"\n// see: http://wiki.eBizCharge.com/developer/soap/howto\ntry {\n $ToCurrency='978';\n $FromCurrency='840';\n $Amount=50; \n $res=$client->currencyConversion($mctoken, $FromCurrency, $ToCurrency, $Amount);\n print_r($res);\n $this->assertEquals($res->FromCurrency, $FromCurrency);\n $this->assertEquals($res->Currency, $ToCurrency);\n $this->assertTrue($res->Rate > 0);\n $this->assertTrue($res->Amount > 0);\n} catch (SoapFault $e) {\n echo $client->__getLastRequest();\n echo $client->__getLastResponse();\n die('Currency conversion failed : '.$e->getMessage());\n}\n?>", "language": "php" } ] } [/block] ## Visual Basic (.Net) [block:code] { "codes": [ { "code": "Dim from As String\n Dim convert As String\n Dim amount As Double\n from = \"036\"\n convert = \"826\"\n amount = 50\n Dim response As eBizCharge.CurrencyConversion = New eBizCharge.CurrencyConversion\n response = client.currencyConversion(token, from, convert, amount)\n MsgBox(response.Amount)", "language": "c" } ] } [/block] ## C Sharp (.Net) [block:code] { "codes": [ { "code": "string from = \"840\";\n string to = \"978\";\n int amount = 50;\n eBizCharge.CurrencyConversion response = new eBizCharge.CurrencyConversion();\n try\n {\n response = client.currencyConversion(token, from, to, amount);\n MessageBox.Show(string.Concat(response.Amount));\n }\n catch (Exception err)\n {\n MessageBox.Show(err.Message);\n }", "language": "csharp" } ] } [/block]