{"_id":"5632a5ed49e16d0d001224cc","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"},"__v":0,"githubsync":"","category":{"_id":"5632a5e749e16d0d00122449","project":"55b933b3146ef121002158d3","__v":1,"version":"5632a5e549e16d0d00122443","pages":["5632a5ed49e16d0d001224cc","5632a5ed49e16d0d001224cd","5632a5ed49e16d0d001224ce","5632a5ed49e16d0d001224cf","5632a5ed49e16d0d001224d0","5632a5ed49e16d0d001224d1","5632a5ed49e16d0d001224d2","5632a5ed49e16d0d001224d3","5632a5ed49e16d0d001224d4","5632a5ed49e16d0d001224d5","5632a5ed49e16d0d001224d6","5632a5ed49e16d0d001224d7","5632a5ed49e16d0d001224d8","5632a5ed49e16d0d001224d9","5632a5ed49e16d0d001224da","5632a5ed49e16d0d001224db","5632a5ed49e16d0d001224dc","5632a5ed49e16d0d001224dd","5632a5ed49e16d0d001224de","5632a5ed49e16d0d001224df","5632a5ed49e16d0d001224e0"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-03T18:12:10.391Z","from_sync":false,"order":7,"slug":"customers-tokenization","title":"Customers (Tokenization)"},"project":"55b933b3146ef121002158d3","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-03T18:13:07.606Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Run a transaction using payment data stored in the customer database.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Description\"\n}\n[/block]\nProcesses a new transaction using the payment details stored for the customer. This is a one time charge and does not use or affect the recurring billing values, such as amount and description, that have been stored for the customer. The transaction result will be tied to the customer and will be visible in the customer's billing history. The customer does not need to have recurring billing enabled for this method to be used.\nSee also [addCustomer](/docs/addcustomer), [addCustomerPaymentMethod](/docs/addcustomerpaymentmethod)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Syntax\"\n}\n[/block]\n[TransactionResponse](/docs/transactionresponse) runCustomerTransaction ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer CustNum, integer PaymentMethodID, [CustomerTransactionRequest](/docs/customertransactionrequest) Parameters )\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\": \"CustNum\",\n    \"1-2\": \"Customer Reference number assigned by the gateway\",\n    \"2-0\": \"integer\",\n    \"2-1\": \"PaymentMethodID\",\n    \"2-2\": \"ID of payment method to use for transaction. Send 0 to use default method\",\n    \"3-0\": \"[CustomerTransactionRequest](/docs/customertransactionrequest)\",\n    \"3-1\": \"Parameters\",\n    \"3-2\": \"Transaction amount, invoice number, etc.\"\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-1\": \"Returns all applicable transaction results including transaction reference number, batch number, transaction result (approved, declined, error), result code, authorization code, AVS result, CVV2 result, Verified by Visa or SecureCode Mastercard results, and converted currency amount and rate.\",\n    \"0-0\": \"[TransactionResponse](/docs/transactionresponse)\"\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 $Parameters=array(\\n  'Command'=>'Sale',\\n 'Details'=>array(\\n   'Invoice' => rand(),\\n   'PONum' => '',\\n   'OrderID' => '',\\n   'Description' => 'Sample Credit Card Sale',\\n   'Amount'=>'1.50' )\\n   );\\n $CustNum='123456';\\n $PayMethod='0';\\n $res=$client->runCustomerTransaction($token, $CustNum, $PayMethod, $Parameters);\\n print_r($res);\\n}\\ncatch (SoapFault $e) {\\n echo $client->__getLastRequest();\\n echo $client->__getLastResponse();\\n die(\\\"runCustomerTransaction 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 custnum As String\\n       custnum = \\\"103125\\\"\\n       Dim paymentMethodID As String\\n       paymentMethodID = \\\"39\\\"\\n       Dim tran As eBizCharge.CustomerTransactionRequest = New eBizCharge.CustomerTransactionRequest\\n       tran.Details = New eBizCharge.TransactionDetail\\n       tran.Details.Invoice = \\\"123456\\\"\\n       tran.Details.Description = \\\"Sample Credit Card Sale\\\"\\n       tran.Details.Amount = 1.05\\n       tran.Details.AmountSpecified = True\\n       Dim response As eBizCharge.TransactionResponse\\n       response = New eBizCharge.TransactionResponse\\n       response = client.runCustomerTransaction(token, custnum, paymentMethodID, tran)\\n       MessageBox.Show(String.Concat(response.Result))\",\n      \"language\": \"c\"\n    }\n  ]\n}\n[/block]\n## C Sharp (.Net)\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"string custNum = \\\"89147\\\";\\n           string paymentMethodID = \\\"19\\\";\\n           eBizCharge.CustomerTransactionRequest tran = new eBizCharge.CustomerTransactionRequest();\\n           tran.Details = new eBizCharge.TransactionDetail();\\n           tran.Details.Invoice = \\\"123456\\\";\\n           tran.Details.Description = \\\"Sample Credit Card Sale\\\";\\n           tran.Details.Amount = 1.05;\\n           tran.Details.AmountSpecified = true;\\n           eBizCharge.TransactionResponse response = new eBizCharge.TransactionResponse();\\n           try\\n           {\\n               response = client.runCustomerTransaction(token, custNum, paymentMethodID, tran);\\n               MessageBox.Show(string.Concat(response.Result));\\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:runCustomerTransaction>\\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<CustNum xsi:type=\\\"xsd:integer\\\">51353</CustNum>\\n<Details xsi:type=\\\"ns1:CustomerTransactionDetail\\\">\\n<Amount xsi:type=\\\"xsd:double\\\">1.5</Amount>\\n<Description xsi:type=\\\"xsd:string\\\">Sample Credit Card Sale</Description>\\n<Invoice xsi:type=\\\"xsd:string\\\">1694755200</Invoice>\\n<OrderID xsi:type=\\\"xsd:string\\\"></OrderID>\\n<PONum xsi:type=\\\"xsd:string\\\"></PONum>\\n</Details>\\n<Command xsi:type=\\\"xsd:string\\\">Sale</Command>\\n<PaymentMethodID xsi:type=\\\"xsd:integer\\\">0</PaymentMethodID>\\n</ns1:runCustomerTransaction>\\n</SOAP-ENV:Body>\\n</SOAP-ENV:Envelope>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"runcustomertransaction","type":"basic","title":"runCustomerTransaction"}

runCustomerTransaction


Run a transaction using payment data stored in the customer database. [block:api-header] { "type": "basic", "title": "Description" } [/block] Processes a new transaction using the payment details stored for the customer. This is a one time charge and does not use or affect the recurring billing values, such as amount and description, that have been stored for the customer. The transaction result will be tied to the customer and will be visible in the customer's billing history. The customer does not need to have recurring billing enabled for this method to be used. See also [addCustomer](/docs/addcustomer), [addCustomerPaymentMethod](/docs/addcustomerpaymentmethod) [block:api-header] { "type": "basic", "title": "Syntax" } [/block] [TransactionResponse](/docs/transactionresponse) runCustomerTransaction ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer CustNum, integer PaymentMethodID, [CustomerTransactionRequest](/docs/customertransactionrequest) Parameters ) [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": "CustNum", "1-2": "Customer Reference number assigned by the gateway", "2-0": "integer", "2-1": "PaymentMethodID", "2-2": "ID of payment method to use for transaction. Send 0 to use default method", "3-0": "[CustomerTransactionRequest](/docs/customertransactionrequest)", "3-1": "Parameters", "3-2": "Transaction amount, invoice number, etc." }, "cols": 3, "rows": 4 } [/block] [block:api-header] { "type": "basic", "title": "Return Value" } [/block] [block:parameters] { "data": { "0-1": "Returns all applicable transaction results including transaction reference number, batch number, transaction result (approved, declined, error), result code, authorization code, AVS result, CVV2 result, Verified by Visa or SecureCode Mastercard results, and converted currency amount and rate.", "0-0": "[TransactionResponse](/docs/transactionresponse)" }, "cols": 2, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] ## PHP [block:code] { "codes": [ { "code": "<?php\ntry {\n $Parameters=array(\n 'Command'=>'Sale',\n 'Details'=>array(\n 'Invoice' => rand(),\n 'PONum' => '',\n 'OrderID' => '',\n 'Description' => 'Sample Credit Card Sale',\n 'Amount'=>'1.50' )\n );\n $CustNum='123456';\n $PayMethod='0';\n $res=$client->runCustomerTransaction($token, $CustNum, $PayMethod, $Parameters);\n print_r($res);\n}\ncatch (SoapFault $e) {\n echo $client->__getLastRequest();\n echo $client->__getLastResponse();\n die(\"runCustomerTransaction failed :\" .$e->getMessage());\n}\n?>", "language": "php" } ] } [/block] ## Visual Basic (.Net) [block:code] { "codes": [ { "code": "Dim custnum As String\n custnum = \"103125\"\n Dim paymentMethodID As String\n paymentMethodID = \"39\"\n Dim tran As eBizCharge.CustomerTransactionRequest = New eBizCharge.CustomerTransactionRequest\n tran.Details = New eBizCharge.TransactionDetail\n tran.Details.Invoice = \"123456\"\n tran.Details.Description = \"Sample Credit Card Sale\"\n tran.Details.Amount = 1.05\n tran.Details.AmountSpecified = True\n Dim response As eBizCharge.TransactionResponse\n response = New eBizCharge.TransactionResponse\n response = client.runCustomerTransaction(token, custnum, paymentMethodID, tran)\n MessageBox.Show(String.Concat(response.Result))", "language": "c" } ] } [/block] ## C Sharp (.Net) [block:code] { "codes": [ { "code": "string custNum = \"89147\";\n string paymentMethodID = \"19\";\n eBizCharge.CustomerTransactionRequest tran = new eBizCharge.CustomerTransactionRequest();\n tran.Details = new eBizCharge.TransactionDetail();\n tran.Details.Invoice = \"123456\";\n tran.Details.Description = \"Sample Credit Card Sale\";\n tran.Details.Amount = 1.05;\n tran.Details.AmountSpecified = true;\n eBizCharge.TransactionResponse response = new eBizCharge.TransactionResponse();\n try\n {\n response = client.runCustomerTransaction(token, custNum, paymentMethodID, tran);\n MessageBox.Show(string.Concat(response.Result));\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:runCustomerTransaction>\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<CustNum xsi:type=\"xsd:integer\">51353</CustNum>\n<Details xsi:type=\"ns1:CustomerTransactionDetail\">\n<Amount xsi:type=\"xsd:double\">1.5</Amount>\n<Description xsi:type=\"xsd:string\">Sample Credit Card Sale</Description>\n<Invoice xsi:type=\"xsd:string\">1694755200</Invoice>\n<OrderID xsi:type=\"xsd:string\"></OrderID>\n<PONum xsi:type=\"xsd:string\"></PONum>\n</Details>\n<Command xsi:type=\"xsd:string\">Sale</Command>\n<PaymentMethodID xsi:type=\"xsd:integer\">0</PaymentMethodID>\n</ns1:runCustomerTransaction>\n</SOAP-ENV:Body>\n</SOAP-ENV:Envelope>", "language": "xml" } ] } [/block]