{"_id":"5632a5e849e16d0d00122467","project":"55b933b3146ef121002158d3","__v":1,"category":{"_id":"5632a5e749e16d0d00122445","project":"55b933b3146ef121002158d3","version":"5632a5e549e16d0d00122443","__v":1,"pages":["5632a5e849e16d0d00122460","5632a5e849e16d0d00122461","5632a5e849e16d0d00122462","5632a5e849e16d0d00122463","5632a5e849e16d0d00122464","5632a5e849e16d0d00122465","5632a5e849e16d0d00122466","5632a5e849e16d0d00122467","5632a5e849e16d0d00122468","5632a5e849e16d0d00122469","5632a5e849e16d0d0012246a","5632a5e849e16d0d0012246b","5632a5e849e16d0d0012246c","5632a5e849e16d0d0012246d","5632a5e849e16d0d0012246e","5632a5e849e16d0d0012246f","5632a5e849e16d0d00122470","5632a5e849e16d0d00122471","5632a5e849e16d0d00122472","5632a5e849e16d0d00122473","5632a5e849e16d0d00122474","5632a5e849e16d0d00122475","5632a5e849e16d0d00122476","5632a5e849e16d0d00122477"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-31T23:43:21.882Z","from_sync":false,"order":3,"slug":"transactions","title":"Transactions"},"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","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-03T17:49:01.674Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"Run a sale based on the credit card details of a previous transaction.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Description\"\n}\n[/block]\nThis method allows you to run a new transaction using the payment data from a previous transaction. Simply pass the reference number ($RefNum) of the previous transaction and the gateway will automatically transfer the credit card or electronic check (ACH) information for use in the new transaction. Some credit card information, such as the card code and magnetic strip cannot be stored. This may cause the new transaction to come in at a higher rate than the original.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Syntax\"\n}\n[/block]\n[TransactionResponse](/docs/transactionresponse) **runQuickSale** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer RefNum, [TransactionDetail](/docs/transactiondetail) Details, boolean AuthOnly )\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\": \"RefNum\",\n    \"1-2\": \"Unique transaction reference number assigned by the gateway.\",\n    \"2-0\": \"[TransactionDetail](/docs/transactiondetail)\",\n    \"2-1\": \"Details\",\n    \"2-2\": \"Request transaction details, including transaction amount, invoice number, customer ID, PO number, and other transaction specific data.\",\n    \"4-0\": \"boolean\",\n    \"4-1\": \"AuthOnly\",\n    \"4-2\": \"If true, the transaction will be authorized, but not be submitted for settlement.\",\n    \"3-0\": \"boolean\",\n    \"3-1\": \"AuthOnly\",\n    \"3-2\": \"If true, the transaction will be authorized, but not be submitted for settlement.\"\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|[TransactionResponse](/docs/transactionresponse) |Returns a TransactionResponse object containing the results of the transaction and all relevant data.|\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Exceptions\"\n}\n[/block]\nThe following exceptions (errors) are applicable to this method.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Message\",\n    \"h-2\": \"Advice\",\n    \"0-0\": \"20002\",\n    \"0-1\": \"Invalid Security Token.\",\n    \"0-2\": \"Supplied security token is invalid.\",\n    \"1-0\": \"10105\",\n    \"1-1\": \"Unable to find original transaction.\",\n    \"1-2\": \"The specified transaction RefNum did not match a eligible transaction or the transaction belongs to a different merchant.\",\n    \"2-0\": \"10136\",\n    \"2-1\": \"Original transaction not approved.\",\n    \"2-2\": \"QuickSale only allowed for transactions that were approved\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\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 $refnum=1009411;\\n $details=array(\\n   \\\"Amount\\\"=>4.00,\\n   \\\"Invoice\\\"=>1234,\\n   \\\"Description\\\"=>\\\"Test Transaction\\\",\\n   \\\"PONum\\\"=>\\\"\\\",\\n   \\\"OrderID\\\"=>1234,\\n   \\\"Tax\\\"=>0,\\n   \\\"Tip\\\"=>0,\\n   \\\"NonTax\\\"=>false,\\n   \\\"Shipping\\\"=>0,\\n   \\\"Discount\\\"=>0,\\n   \\\"Subtotal\\\"=>4.00\\n   );\\n print_r($client->runQuickSale($token,$refnum, $details, true));\\n}\\ncatch(SoapFault $e) {    \\n echo $e->getMessage();\\n echo \\\"\\\\n\\\\nRequest: \\\" . $client->__getLastRequest();\\n echo \\\"\\\\n\\\\nResponse: \\\" . $client->__getLastResponse();\\n}\\n?>\",\n      \"language\": \"php\"\n    }\n  ]\n}\n[/block]\n## Java \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"try {\\n //Set RefNum to the transaction refference number\\n //you want to run a quick sale on\\n BigInteger RefNum = new BigInteger(\\\"123456789\\\");\\n //populate transaction details\\n TransactionDetail details = new TransactionDetail();\\n   details.setAmount(22.34);\\n   details.setDescription(\\\"QuickSale\\\");\\n   details.setInvoice(\\\"119891\\\");\\n // Create response object\\n TransactionResponse response;\\n response = client.runQuickSale(token, RefNum, details, false);\\n System.out.println(\\\"Response: \\\" + response.getResult());\\n System.out.println(\\\"RefNum: \\\" + response.getRefNum());\\n} catch (Exception e) {\\n   System.out.println(\\\"Soap Exception: \\\" + e.getMessage());\\n}\",\n      \"language\": \"java\"\n    }\n  ]\n}\n[/block]\n## Visual Basic (.Net) \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Dim client As eBizCharge.eBizChargeService = New eBizCharge.eBizChargeService\\n       Dim token As eBizCharge.ueSecurityToken\\n       token = Me.CreateToken(\\\"714SSUxv1uohng2XkMJ7kLpETsu58G66\\\", \\\"1234\\\")\\n       Dim refnum As Integer\\n       Dim details As eBizCharge.TransactionDetail = New eBizCharge.TransactionDetail\\n       Dim authonly As Boolean\\n       refnum = \\\"46990567\\\"\\n       details.Amount = \\\"34.50\\\"\\n       details.AmountSpecified = True\\n       details.Description = \\\"Example QuickSale\\\"\\n       details.Invoice = \\\"123456\\\"\\n       authonly = False\\n       Dim response As eBizCharge.TransactionResponse\\n       response = client.runQuickSale(token, refnum, details, authonly)\\n       If response.ResultCode = \\\"A\\\" Then\\n           MsgBox(\\\"Transaction Approved, Refernce Number: \\\" & response.RefNum)\\n       ElseIf response.ResultCode = \\\"D\\\" Then\\n           MsgBox(\\\"Transaction Declined, Reason: \\\" & response.Error)\\n       Else\\n           MsgBox(\\\"Transaction Error, Reason: \\\" & response.Error)\\n       End If\",\n      \"language\": \"c\"\n    }\n  ]\n}\n[/block]\n## C Sharp (.Net)\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"eBizCharge.TransactionDetail details = new eBizCharge.TransactionDetail();\\n           string refnum;\\n           bool authonly;\\n           refnum = \\\"46973415\\\";\\n           authonly = false;\\n           details.Amount = 34.50;\\n           details.AmountSpecified = true;\\n           details.Description = \\\"Example QuickSale\\\";\\n           details.Invoice = \\\"123456\\\";\\n           eBizCharge.TransactionResponse response = new eBizCharge.TransactionResponse();\\n           try\\n           {\\n               response = client.runQuickSale(token, refnum, details, authonly);\\n               if (response.ResultCode == \\\"A\\\")\\n               {\\n                   MessageBox.Show(string.Concat(\\\"Transaction Approved, RefNum: \\\",\\n                   response.RefNum));\\n               }\\n               else\\n               {\\n                   MessageBox.Show(string.Concat(\\\"Transaction Failed: \\\",\\n                   response.Error));\\n               }\\n           }\\n           catch (Exception err)\\n           {\\n               MessageBox.Show(err.Message);\\n           }\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]\n## XML \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<SOAP-ENV:Envelope xmlns:SOAP-ENV=\\\"http://schemas.xmlsoap.org/soap/envelope/\\\"\\nxmlns:ns1=\\\"urn:eBizCharge\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\"\\nxmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\"\\nxmlns:SOAP-ENC=\\\"http://schemas.xmlsoap.org/soap/encoding/\\\"\\nSOAP-ENV:encodingStyle=\\\"http://schemas.xmlsoap.org/soap/encoding/\\\">\\n<SOAP-ENV:Body>\\n<ns1:runQuickSale>\\n<Token xsi:type=\\\"ns1:ueSecurityToken\\\">\\n<ClientIP xsi:type=\\\"xsd:string\\\">192.168.0.1</ClientIP>\\n<PinHash xsi:type=\\\"ns1:ueHash\\\">\\n<HashValue xsi:type=\\\"xsd:string\\\">11ac55b0a0b59f8f028dbf85bc32266fa973dd0e</HashValue>\\n<Seed xsi:type=\\\"xsd:string\\\">12678150211876663375</Seed>\\n<Type xsi:type=\\\"xsd:string\\\">sha1</Type>\\n</PinHash>\\n<SourceKey xsi:type=\\\"xsd:string\\\">HB4P7C4K2w2ZCQQQXRqrxDj6agrS2NIT</SourceKey>\\n</Token>\\n<RefNum xsi:type=\\\"xsd:integer\\\">1118268</RefNum>\\n<Details xsi:type=\\\"ns1:TransactionDetail\\\">\\n<Amount xsi:type=\\\"xsd:double\\\">29</Amount>\\n<Clerk xsi:type=\\\"xsd:string\\\">John Doe</Clerk>\\n<Currency xsi:type=\\\"xsd:integer\\\">0</Currency>\\n<Description xsi:type=\\\"xsd:string\\\">Example Transaction</Description>\\n<Discount xsi:type=\\\"xsd:double\\\">1</Discount>\\n<Invoice xsi:type=\\\"xsd:string\\\">44539</Invoice>\\n<OrderID xsi:type=\\\"xsd:string\\\">12345</OrderID>\\n<PONum xsi:type=\\\"xsd:string\\\">54321</PONum>\\n<Shipping xsi:type=\\\"xsd:double\\\">2</Shipping>\\n<Subtotal xsi:type=\\\"xsd:double\\\">16</Subtotal>\\n<Table xsi:type=\\\"xsd:string\\\">1</Table>\\n<Tax xsi:type=\\\"xsd:double\\\">4</Tax>\\n<Terminal xsi:type=\\\"xsd:string\\\">15</Terminal>\\n<Tip xsi:type=\\\"xsd:double\\\">8</Tip>\\n</Details>\\n<AuthOnly xsi:type=\\\"xsd:boolean\\\">false</AuthOnly>\\n</ns1:runQuickSale>\\n</SOAP-ENV:Body>\\n</SOAP-ENV:Envelope>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"runquicksale","type":"basic","title":"runQuickSale"}
Run a sale based on the credit card details of a previous transaction. [block:api-header] { "type": "basic", "title": "Description" } [/block] This method allows you to run a new transaction using the payment data from a previous transaction. Simply pass the reference number ($RefNum) of the previous transaction and the gateway will automatically transfer the credit card or electronic check (ACH) information for use in the new transaction. Some credit card information, such as the card code and magnetic strip cannot be stored. This may cause the new transaction to come in at a higher rate than the original. [block:api-header] { "type": "basic", "title": "Syntax" } [/block] [TransactionResponse](/docs/transactionresponse) **runQuickSale** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer RefNum, [TransactionDetail](/docs/transactiondetail) Details, boolean AuthOnly ) [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": "RefNum", "1-2": "Unique transaction reference number assigned by the gateway.", "2-0": "[TransactionDetail](/docs/transactiondetail)", "2-1": "Details", "2-2": "Request transaction details, including transaction amount, invoice number, customer ID, PO number, and other transaction specific data.", "4-0": "boolean", "4-1": "AuthOnly", "4-2": "If true, the transaction will be authorized, but not be submitted for settlement.", "3-0": "boolean", "3-1": "AuthOnly", "3-2": "If true, the transaction will be authorized, but not be submitted for settlement." }, "cols": 3, "rows": 4 } [/block] [block:api-header] { "type": "basic", "title": "Return Value" } [/block] |[TransactionResponse](/docs/transactionresponse) |Returns a TransactionResponse object containing the results of the transaction and all relevant data.| [block:api-header] { "type": "basic", "title": "Exceptions" } [/block] The following exceptions (errors) are applicable to this method. [block:parameters] { "data": { "h-0": "Code", "h-1": "Message", "h-2": "Advice", "0-0": "20002", "0-1": "Invalid Security Token.", "0-2": "Supplied security token is invalid.", "1-0": "10105", "1-1": "Unable to find original transaction.", "1-2": "The specified transaction RefNum did not match a eligible transaction or the transaction belongs to a different merchant.", "2-0": "10136", "2-1": "Original transaction not approved.", "2-2": "QuickSale only allowed for transactions that were approved" }, "cols": 3, "rows": 3 } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] ## PHP [block:code] { "codes": [ { "code": "<?php\ntry {\n $refnum=1009411;\n $details=array(\n \"Amount\"=>4.00,\n \"Invoice\"=>1234,\n \"Description\"=>\"Test Transaction\",\n \"PONum\"=>\"\",\n \"OrderID\"=>1234,\n \"Tax\"=>0,\n \"Tip\"=>0,\n \"NonTax\"=>false,\n \"Shipping\"=>0,\n \"Discount\"=>0,\n \"Subtotal\"=>4.00\n );\n print_r($client->runQuickSale($token,$refnum, $details, true));\n}\ncatch(SoapFault $e) { \n echo $e->getMessage();\n echo \"\\n\\nRequest: \" . $client->__getLastRequest();\n echo \"\\n\\nResponse: \" . $client->__getLastResponse();\n}\n?>", "language": "php" } ] } [/block] ## Java [block:code] { "codes": [ { "code": "try {\n //Set RefNum to the transaction refference number\n //you want to run a quick sale on\n BigInteger RefNum = new BigInteger(\"123456789\");\n //populate transaction details\n TransactionDetail details = new TransactionDetail();\n details.setAmount(22.34);\n details.setDescription(\"QuickSale\");\n details.setInvoice(\"119891\");\n // Create response object\n TransactionResponse response;\n response = client.runQuickSale(token, RefNum, details, false);\n System.out.println(\"Response: \" + response.getResult());\n System.out.println(\"RefNum: \" + response.getRefNum());\n} catch (Exception e) {\n System.out.println(\"Soap Exception: \" + e.getMessage());\n}", "language": "java" } ] } [/block] ## Visual Basic (.Net) [block:code] { "codes": [ { "code": "Dim client As eBizCharge.eBizChargeService = New eBizCharge.eBizChargeService\n Dim token As eBizCharge.ueSecurityToken\n token = Me.CreateToken(\"714SSUxv1uohng2XkMJ7kLpETsu58G66\", \"1234\")\n Dim refnum As Integer\n Dim details As eBizCharge.TransactionDetail = New eBizCharge.TransactionDetail\n Dim authonly As Boolean\n refnum = \"46990567\"\n details.Amount = \"34.50\"\n details.AmountSpecified = True\n details.Description = \"Example QuickSale\"\n details.Invoice = \"123456\"\n authonly = False\n Dim response As eBizCharge.TransactionResponse\n response = client.runQuickSale(token, refnum, details, authonly)\n If response.ResultCode = \"A\" Then\n MsgBox(\"Transaction Approved, Refernce Number: \" & response.RefNum)\n ElseIf response.ResultCode = \"D\" Then\n MsgBox(\"Transaction Declined, Reason: \" & response.Error)\n Else\n MsgBox(\"Transaction Error, Reason: \" & response.Error)\n End If", "language": "c" } ] } [/block] ## C Sharp (.Net) [block:code] { "codes": [ { "code": "eBizCharge.TransactionDetail details = new eBizCharge.TransactionDetail();\n string refnum;\n bool authonly;\n refnum = \"46973415\";\n authonly = false;\n details.Amount = 34.50;\n details.AmountSpecified = true;\n details.Description = \"Example QuickSale\";\n details.Invoice = \"123456\";\n eBizCharge.TransactionResponse response = new eBizCharge.TransactionResponse();\n try\n {\n response = client.runQuickSale(token, refnum, details, authonly);\n if (response.ResultCode == \"A\")\n {\n MessageBox.Show(string.Concat(\"Transaction Approved, RefNum: \",\n response.RefNum));\n }\n else\n {\n MessageBox.Show(string.Concat(\"Transaction Failed: \",\n response.Error));\n }\n }\n catch (Exception err)\n {\n MessageBox.Show(err.Message);\n }", "language": "csharp" } ] } [/block] ## XML [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<SOAP-ENV:Envelope xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\"\nxmlns:ns1=\"urn:eBizCharge\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\"\nxmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\nxmlns:SOAP-ENC=\"http://schemas.xmlsoap.org/soap/encoding/\"\nSOAP-ENV:encodingStyle=\"http://schemas.xmlsoap.org/soap/encoding/\">\n<SOAP-ENV:Body>\n<ns1:runQuickSale>\n<Token xsi:type=\"ns1:ueSecurityToken\">\n<ClientIP xsi:type=\"xsd:string\">192.168.0.1</ClientIP>\n<PinHash xsi:type=\"ns1:ueHash\">\n<HashValue xsi:type=\"xsd:string\">11ac55b0a0b59f8f028dbf85bc32266fa973dd0e</HashValue>\n<Seed xsi:type=\"xsd:string\">12678150211876663375</Seed>\n<Type xsi:type=\"xsd:string\">sha1</Type>\n</PinHash>\n<SourceKey xsi:type=\"xsd:string\">HB4P7C4K2w2ZCQQQXRqrxDj6agrS2NIT</SourceKey>\n</Token>\n<RefNum xsi:type=\"xsd:integer\">1118268</RefNum>\n<Details xsi:type=\"ns1:TransactionDetail\">\n<Amount xsi:type=\"xsd:double\">29</Amount>\n<Clerk xsi:type=\"xsd:string\">John Doe</Clerk>\n<Currency xsi:type=\"xsd:integer\">0</Currency>\n<Description xsi:type=\"xsd:string\">Example Transaction</Description>\n<Discount xsi:type=\"xsd:double\">1</Discount>\n<Invoice xsi:type=\"xsd:string\">44539</Invoice>\n<OrderID xsi:type=\"xsd:string\">12345</OrderID>\n<PONum xsi:type=\"xsd:string\">54321</PONum>\n<Shipping xsi:type=\"xsd:double\">2</Shipping>\n<Subtotal xsi:type=\"xsd:double\">16</Subtotal>\n<Table xsi:type=\"xsd:string\">1</Table>\n<Tax xsi:type=\"xsd:double\">4</Tax>\n<Terminal xsi:type=\"xsd:string\">15</Terminal>\n<Tip xsi:type=\"xsd:double\">8</Tip>\n</Details>\n<AuthOnly xsi:type=\"xsd:boolean\">false</AuthOnly>\n</ns1:runQuickSale>\n</SOAP-ENV:Body>\n</SOAP-ENV:Envelope>", "language": "xml" } ] } [/block]