{"_id":"5632a5eb49e16d0d001224ac","__v":0,"project":"55b933b3146ef121002158d3","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"},"githubsync":"","user":"55b932ba8fd1a02b00f496c8","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"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-04T17:47:42.938Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"Converts multiple amounts in a single method call.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Description\"\n}\n[/block]\nThis method allows you to complete a large batch of currency conversions all at once without having to use the [currencyConversion](/docs/currencyconversion-1) method for each conversion.\nCurrently this method supports bulk conversions from a single currency to another single currency and not several currencies simultaneously. (ie: if you want to convert fifty amounts from USD [US dollars] to CAD [Canadian dollars] and twenty amounts from USD to EUR [Euros] you would need to run two separate **bulkCurrencyConversion** method calls.)\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.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Syntax\"\n}\n[/block]\n[CurrencyConversion](/docs/currencyconversion-1) **bulkCurrencyConversion** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer FromCurrency, integer ToCurrency, double Amounts )\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\": \"integer\",\n    \"1-1\": \"FromCurrency\",\n    \"1-2\": \"Currency code funds will be converted from.\",\n    \"2-0\": \"integer\",\n    \"2-1\": \"ToCurrency\",\n    \"2-2\": \"Currency code funds will be converted to.\",\n    \"3-0\": \"double\",\n    \"3-1\": \"Amounts\",\n    \"3-2\": \"Array of Amounts being 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 conversion rates and amounts of currency converted.\"\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\\ntry {\\n $ToCurrency='978';\\n $FromCurrency='840';\\n $Amounts=array(\\n   50.10,\\n   11.23,\\n   34.21,\\n   12.23\\n   );    \\n $res=$client->bulkCurrencyConversion($mctoken, $FromCurrency, $ToCurrency, $Amounts);\\n print_r($res);\\n $this->assertEquals(count($res), count($Amounts));\\n $this->assertEquals($res[0]->FromCurrency, $FromCurrency);\\n $this->assertEquals($res[0]->Currency, $ToCurrency);\\n $this->assertEquals($res[0]->FromAmount, $Amounts[0]);\\n $this->assertTrue($res[0]->Rate > 0);\\n $this->assertTrue($res[0]->Amount > 0);\\n }\\ncatch (SoapFault $e) {\\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(0 To 2) As Double\\n       from = \\\"036\\\"\\n       convert = \\\"826\\\"\\n       amount(0) = 10\\n       amount(1) = 20\\n       amount(2) = 30\\n       Dim response() As eBizCharge.CurrencyConversion\\n       response = client.bulkCurrencyConversion(token, from, convert, amount)\\n       MsgBox(response.Length)\",\n      \"language\": \"c\"\n    }\n  ]\n}\n[/block]\n## C Sharp (.Net)\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"string from = \\\"124\\\";\\n           string to = \\\"826\\\";\\n           double[] amount = new double[3];\\n           amount[0] = 10;\\n           amount[1] = 5;\\n           amount[2] = 19.99;\\n           //eBizCharge.CurrencyConversion response = new eBizCharge.CurrencyConversion();\\n           try\\n           {\\n               eBizCharge.CurrencyConversion[] response = client.bulkCurrencyConversion(token, from, to, amount);\\n               MessageBox.Show(string.Concat(response.Length));\\n           }\\n           catch (Exception err)\\n           {\\n               MessageBox.Show(err.Message);\\n           }\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"bulkcurrencyconversion","type":"basic","title":"bulkCurrencyConversion"}

bulkCurrencyConversion


Converts multiple amounts in a single method call. [block:api-header] { "type": "basic", "title": "Description" } [/block] This method allows you to complete a large batch of currency conversions all at once without having to use the [currencyConversion](/docs/currencyconversion-1) method for each conversion. Currently this method supports bulk conversions from a single currency to another single currency and not several currencies simultaneously. (ie: if you want to convert fifty amounts from USD [US dollars] to CAD [Canadian dollars] and twenty amounts from USD to EUR [Euros] you would need to run two separate **bulkCurrencyConversion** method calls.) 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. [block:api-header] { "type": "basic", "title": "Syntax" } [/block] [CurrencyConversion](/docs/currencyconversion-1) **bulkCurrencyConversion** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer FromCurrency, integer ToCurrency, double Amounts ) [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": "integer", "1-1": "FromCurrency", "1-2": "Currency code funds will be converted from.", "2-0": "integer", "2-1": "ToCurrency", "2-2": "Currency code funds will be converted to.", "3-0": "double", "3-1": "Amounts", "3-2": "Array of Amounts being 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 conversion rates and amounts of currency converted." }, "cols": 2, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] ## PHP [block:code] { "codes": [ { "code": "<?php\ntry {\n $ToCurrency='978';\n $FromCurrency='840';\n $Amounts=array(\n 50.10,\n 11.23,\n 34.21,\n 12.23\n ); \n $res=$client->bulkCurrencyConversion($mctoken, $FromCurrency, $ToCurrency, $Amounts);\n print_r($res);\n $this->assertEquals(count($res), count($Amounts));\n $this->assertEquals($res[0]->FromCurrency, $FromCurrency);\n $this->assertEquals($res[0]->Currency, $ToCurrency);\n $this->assertEquals($res[0]->FromAmount, $Amounts[0]);\n $this->assertTrue($res[0]->Rate > 0);\n $this->assertTrue($res[0]->Amount > 0);\n }\ncatch (SoapFault $e) {\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(0 To 2) As Double\n from = \"036\"\n convert = \"826\"\n amount(0) = 10\n amount(1) = 20\n amount(2) = 30\n Dim response() As eBizCharge.CurrencyConversion\n response = client.bulkCurrencyConversion(token, from, convert, amount)\n MsgBox(response.Length)", "language": "c" } ] } [/block] ## C Sharp (.Net) [block:code] { "codes": [ { "code": "string from = \"124\";\n string to = \"826\";\n double[] amount = new double[3];\n amount[0] = 10;\n amount[1] = 5;\n amount[2] = 19.99;\n //eBizCharge.CurrencyConversion response = new eBizCharge.CurrencyConversion();\n try\n {\n eBizCharge.CurrencyConversion[] response = client.bulkCurrencyConversion(token, from, to, amount);\n MessageBox.Show(string.Concat(response.Length));\n }\n catch (Exception err)\n {\n MessageBox.Show(err.Message);\n }", "language": "csharp" } ] } [/block]