{"_id":"5632a5ed49e16d0d001224db","githubsync":"","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,"user":"55b932ba8fd1a02b00f496c8","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:17:39.824Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":15,"body":"Replace all data for customer specified by CustNum.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Description\"\n}\n[/block]\nThis method completely replaces all existing customer data for a specific customer.\nThis method requires the use of the CustNum, a unique customer number assigned by the gateway. If you have lost or cannot remember the customer's CustNum, use the [searchCustomers](/docs/searchcustomers) method to find the correct CustNum.\nIf you wish to change all of the data EXCEPT for the credit card or checking account information, you must type XXXX into the credit card or check fields. This will change all of the other data, while saving the previously stored credit card and checking information.\nDepending on your programming language, you should be able to retrieve the customer object using the [getCustomer](/docs/getcustomer) method, alter any fields you want and then submit it back using the [updateCustomer](/docs/updatecustomer) method.\nTo update only a few specific fields, use the [quickUpdateCustomer.html](/docs/quickupdatecustomer) method.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Syntax\"\n}\n[/block]\nboolean **updateCustomer** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer CustNum, [CustomerObject](/docs/customerobject) CustomerData )\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\": \"A unique customer number assigned by the gateway.\",\n    \"2-0\": \"[CustomerObject](/docs/customerobject)\",\n    \"2-1\": \"CustomerData\",\n    \"2-2\": \"Includes customer information such as customer number, merchant assigned customer ID, billing address, receipt settings, recurring billing settings, and other pertinent information.\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\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\": \"boolean\",\n    \"0-1\": \"Returns confirmation of customer update only if data revision was successful. If update fails, an exception will be thrown.\"\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 $customer=$tran->getCustomer($token, 1309);\\n $customer->Amount=29.99;\\n $customer->Description='New Description';\\n $res=$client->updateCustomer($token, 1309, $customer);\\n print_r($res);\\n}\\ncatch(SoapFault $e) {\\n echo \\\"SoapFault: \\\" .$e->getMessage();\\n print_r($e);\\n echo \\\"\\\\n\\\\nRequest: \\\" . $client->__getLastRequest();\\n echo \\\"\\\\n\\\\nResponse: \\\" . $client->__getLastResponse();\\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 customer As eBizCharge.CustomerObject = New eBizCharge.CustomerObject\\n       customer = client.getCustomer(token, CustNum)\\n       customer.Amount = 29.99\\n       Dim response As Boolean\\n       response = client.updateCustomer(token, CustNum, customer)\\n       MsgBox(response)\",\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           eBizCharge.CustomerObject customer = new eBizCharge.CustomerObject();\\n           customer = client.getCustomer(token, CustNum);\\n           customer.Amount = 29.99;\\n           Boolean response;\\n           try\\n           {\\n               response = client.updateCustomer(token, CustNum, customer);\\n               MessageBox.Show(string.Concat(response));\\n           }\\n           catch (Exception err)\\n           {\\n               MessageBox.Show(err.Message);\\n           }\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"updatecustomer","type":"basic","title":"updateCustomer"}
Replace all data for customer specified by CustNum. [block:api-header] { "type": "basic", "title": "Description" } [/block] This method completely replaces all existing customer data for a specific customer. This method requires the use of the CustNum, a unique customer number assigned by the gateway. If you have lost or cannot remember the customer's CustNum, use the [searchCustomers](/docs/searchcustomers) method to find the correct CustNum. If you wish to change all of the data EXCEPT for the credit card or checking account information, you must type XXXX into the credit card or check fields. This will change all of the other data, while saving the previously stored credit card and checking information. Depending on your programming language, you should be able to retrieve the customer object using the [getCustomer](/docs/getcustomer) method, alter any fields you want and then submit it back using the [updateCustomer](/docs/updatecustomer) method. To update only a few specific fields, use the [quickUpdateCustomer.html](/docs/quickupdatecustomer) method. [block:api-header] { "type": "basic", "title": "Syntax" } [/block] boolean **updateCustomer** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer CustNum, [CustomerObject](/docs/customerobject) CustomerData ) [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": "A unique customer number assigned by the gateway.", "2-0": "[CustomerObject](/docs/customerobject)", "2-1": "CustomerData", "2-2": "Includes customer information such as customer number, merchant assigned customer ID, billing address, receipt settings, recurring billing settings, and other pertinent information." }, "cols": 3, "rows": 3 } [/block] [block:api-header] { "type": "basic", "title": "Return Value" } [/block] [block:parameters] { "data": { "0-0": "boolean", "0-1": "Returns confirmation of customer update only if data revision was successful. If update fails, an exception will be thrown." }, "cols": 2, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] ## PHP [block:code] { "codes": [ { "code": "<?php\ntry {\n $customer=$tran->getCustomer($token, 1309);\n $customer->Amount=29.99;\n $customer->Description='New Description';\n $res=$client->updateCustomer($token, 1309, $customer);\n print_r($res);\n}\ncatch(SoapFault $e) {\n echo \"SoapFault: \" .$e->getMessage();\n print_r($e);\n echo \"\\n\\nRequest: \" . $client->__getLastRequest();\n echo \"\\n\\nResponse: \" . $client->__getLastResponse();\n}\n?>", "language": "php" } ] } [/block] ## Visual Basic (.Net) [block:code] { "codes": [ { "code": "Dim CustNum As String\n CustNum = \"103125\"\n Dim customer As eBizCharge.CustomerObject = New eBizCharge.CustomerObject\n customer = client.getCustomer(token, CustNum)\n customer.Amount = 29.99\n Dim response As Boolean\n response = client.updateCustomer(token, CustNum, customer)\n MsgBox(response)", "language": "c" } ] } [/block] ## C Sharp (.Net) [block:code] { "codes": [ { "code": "string CustNum = \"89147\";\n eBizCharge.CustomerObject customer = new eBizCharge.CustomerObject();\n customer = client.getCustomer(token, CustNum);\n customer.Amount = 29.99;\n Boolean response;\n try\n {\n response = client.updateCustomer(token, CustNum, customer);\n MessageBox.Show(string.Concat(response));\n }\n catch (Exception err)\n {\n MessageBox.Show(err.Message);\n }", "language": "csharp" } ] } [/block]