{"_id":"5632a5ed49e16d0d001224dc","user":"55b932ba8fd1a02b00f496c8","__v":0,"project":"55b933b3146ef121002158d3","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)"},"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"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-03T18:18:09.290Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":16,"body":"Update customer data in selected fields only.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Description\"\n}\n[/block]\nThis method allows you to update only specified data for a customer record, rather than replacing all existing data. Fields that can be changed using this method include a customer's contact information, as well as customized notes on their account and information regarding any recurring billing cycle that they have been enabled for, such as the amount to be billed, and the number of transactions remaining.\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.\nThis method uses the UpdateData array containing the fields that you would like to update. The “key” of each element is the name of the field you wish to change and the “value” of the element is the new value that you would like to assign.\nThe following fields may be updated using this method:\n  * FirstName\n  * LastName\n  * CustomerID\n  * Company\n  * Address\n  * Address2\n  * City\n  * State\n  * Zip\n  * Country\n  * Phone\n  * Fax\n  * Email\n  * URL\n  * ReceiptNote\n  * SendReceipt\n  * Notes\n  * Description\n  * OrderID\n  * Enabled\n  * Schedule\n  * Next\n  * NumLeft\n  * Amount\n  * CustomData\n  * Source\n  * User\n  * Card Number\n  * CardExp\n  * Account Number\n  * Routing Number\n  * CheckFormat or RecordType \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Syntax\"\n}\n[/block]\nboolean **quickUpdateCustomer** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer CustNum, [FieldValue](/docs/fieldvalue) UpdateData )\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\": \"[FieldValue](/docs/fieldvalue)\",\n    \"2-1\": \"UpdateData\",\n    \"2-2\": \"Array of fields to be updated.\"\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 request only if successful. If request 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 $custnum='532';\\n $update=array(\\n   array('Field'=>'CardExp'   , 'Value'=>'0913'),\\n   array('Field'=>'CardNumber', 'Value'=>'4444555566667779'),\\n   array('Field'=>'Amount'    , 'Value'=>'1.34'),\\n   array('Field'=>'Address'   , 'Value'=>'Time: ' . mktime()),\\n   array('Field'=>'CustomData', 'Value'=> serialize(array(\\\"MyField\\\" => \\\"myval\\\"))),      \\n   );\\n print_r($client->quickUpdateCustomer($token,$custnum, $update));\\n}\\ncatch(SoapFault $e) {\\n echo \\\"Error: \\\" . $e->faultstring;\\n echo \\\"\\\\n\\\\nRequest: \\\" . $client->__getLastRequest();\\n echo \\\"\\\\n\\\\nResponse: \\\" . $client->__getLastResponse();\\n}\\ncatch(Exception $e) {\\n echo 'Error: ' . $e->getMessage();\\n}\\n?>  \",\n      \"language\": \"php\"\n    }\n  ]\n}\n[/block]\n## Java \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"try {\\n       BigInteger custnum = new BigInteger(\\\"1235\\\");\\n       // Create array of fields to update\\n       FieldValueArray updateData = new FieldValueArray();\\n       updateData.add(new FieldValue(\\\"Schedule\\\", \\\"daily\\\"));\\n       updateData.add(new FieldValue(\\\"Amount\\\", \\\"5.00\\\"));\\n       // run quick update\\n       boolean response = client.quickUpdateCustomer(token, custnum, updateData);\\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 custNum As String\\n       custNum = \\\"103125\\\"\\n       Dim fields(0 To 1) As eBizCharge.FieldValue\\n       For i As Integer = 0 To 1\\n           fields(i) = New eBizCharge.FieldValue\\n       Next i\\n       fields(0).Field = \\\"Schedule\\\"\\n       fields(0).Value = \\\"monthly\\\"\\n       fields(1).Field = \\\"Amount\\\"\\n       fields(1).Value = \\\"5.00\\\"\\n       Dim response As Boolean\\n       response = client.quickUpdateCustomer(token, custNum, fields)\\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.FieldValue[] fields = new eBizCharge.FieldValue[2];\\n           for (int i = 0; i < 2; i++) {\\n               fields[i] = new eBizCharge.FieldValue();\\n           }\\n           fields[0].Field = \\\"Schedule\\\";   fields[0].Value = \\\"monthly\\\";\\n           fields[1].Field = \\\"Amount\\\";     fields[1].Value = \\\"5.00\\\";\\n           Boolean response;\\n           try\\n           {\\n               response = client.quickUpdateCustomer(token, custNum, fields);\\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":"quickupdatecustomer","type":"basic","title":"quickUpdateCustomer"}

quickUpdateCustomer


Update customer data in selected fields only. [block:api-header] { "type": "basic", "title": "Description" } [/block] This method allows you to update only specified data for a customer record, rather than replacing all existing data. Fields that can be changed using this method include a customer's contact information, as well as customized notes on their account and information regarding any recurring billing cycle that they have been enabled for, such as the amount to be billed, and the number of transactions remaining. 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. This method uses the UpdateData array containing the fields that you would like to update. The “key” of each element is the name of the field you wish to change and the “value” of the element is the new value that you would like to assign. The following fields may be updated using this method: * FirstName * LastName * CustomerID * Company * Address * Address2 * City * State * Zip * Country * Phone * Fax * Email * URL * ReceiptNote * SendReceipt * Notes * Description * OrderID * Enabled * Schedule * Next * NumLeft * Amount * CustomData * Source * User * Card Number * CardExp * Account Number * Routing Number * CheckFormat or RecordType [block:api-header] { "type": "basic", "title": "Syntax" } [/block] boolean **quickUpdateCustomer** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer CustNum, [FieldValue](/docs/fieldvalue) UpdateData ) [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": "[FieldValue](/docs/fieldvalue)", "2-1": "UpdateData", "2-2": "Array of fields to be updated." }, "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 request only if successful. If request 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 $custnum='532';\n $update=array(\n array('Field'=>'CardExp' , 'Value'=>'0913'),\n array('Field'=>'CardNumber', 'Value'=>'4444555566667779'),\n array('Field'=>'Amount' , 'Value'=>'1.34'),\n array('Field'=>'Address' , 'Value'=>'Time: ' . mktime()),\n array('Field'=>'CustomData', 'Value'=> serialize(array(\"MyField\" => \"myval\"))), \n );\n print_r($client->quickUpdateCustomer($token,$custnum, $update));\n}\ncatch(SoapFault $e) {\n echo \"Error: \" . $e->faultstring;\n echo \"\\n\\nRequest: \" . $client->__getLastRequest();\n echo \"\\n\\nResponse: \" . $client->__getLastResponse();\n}\ncatch(Exception $e) {\n echo 'Error: ' . $e->getMessage();\n}\n?> ", "language": "php" } ] } [/block] ## Java [block:code] { "codes": [ { "code": "try {\n BigInteger custnum = new BigInteger(\"1235\");\n // Create array of fields to update\n FieldValueArray updateData = new FieldValueArray();\n updateData.add(new FieldValue(\"Schedule\", \"daily\"));\n updateData.add(new FieldValue(\"Amount\", \"5.00\"));\n // run quick update\n boolean response = client.quickUpdateCustomer(token, custnum, updateData);\n} catch (Exception e) {\n System.out.println(\"Soap Exception: \" + e.getMessage());\n}", "language": "java" } ] } [/block] ## Visual Basic (.Net) [block:code] { "codes": [ { "code": "Dim custNum As String\n custNum = \"103125\"\n Dim fields(0 To 1) As eBizCharge.FieldValue\n For i As Integer = 0 To 1\n fields(i) = New eBizCharge.FieldValue\n Next i\n fields(0).Field = \"Schedule\"\n fields(0).Value = \"monthly\"\n fields(1).Field = \"Amount\"\n fields(1).Value = \"5.00\"\n Dim response As Boolean\n response = client.quickUpdateCustomer(token, custNum, fields)\n MsgBox(response)", "language": "c" } ] } [/block] ## C Sharp (.Net) [block:code] { "codes": [ { "code": "string custNum = \"89147\";\n eBizCharge.FieldValue[] fields = new eBizCharge.FieldValue[2];\n for (int i = 0; i < 2; i++) {\n fields[i] = new eBizCharge.FieldValue();\n }\n fields[0].Field = \"Schedule\"; fields[0].Value = \"monthly\";\n fields[1].Field = \"Amount\"; fields[1].Value = \"5.00\";\n Boolean response;\n try\n {\n response = client.quickUpdateCustomer(token, custNum, fields);\n MessageBox.Show(string.Concat(response));\n }\n catch (Exception err)\n {\n MessageBox.Show(err.Message);\n }", "language": "csharp" } ] } [/block]