{"_id":"5632a5ed49e16d0d001224cd","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","__v":0,"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"},"user":"55b932ba8fd1a02b00f496c8","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-03T18:13:30.612Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"Enable recurring billing for a customer specified by CustNum.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Description\"\n}\n[/block]\nThis method allows you to begin a recurring billing cycle for an individual customer using their CustNum (unique customer number assigned by the gateway) as a reference. If you have lost or cannot remember the customer's CustNum, use the [searchCustomerID](/docs/searchcustomerid) method to retrieve it.\nThe recurring billing cycle can begin on any date you choose and can be set to any of the following cycles: Daily, Weekly, Bi-Weekly (every 2 weeks), Monthly, Bi-Monthly (every 2 months), Quarterly, Bi-Annually (every 6 months), and Annually.\nYou can also set the start and end dates, amount to be charged, and the total number of transactions for the recurring billing cycle.\nOnce a customer has been added to a recurring billing cycle, you can monitor and change the recurring billing settings from within the merchant console.\nYou can disable a customer's recurring billing cycle at any time using the [disableCustomer](/docs/disablecustomer) method.\nFor more information about recurring billing, please refer to the support documentation in the merchant console.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Syntax\"\n}\n[/block]\nboolean **enableCustomer** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer CustNum )\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  },\n  \"cols\": 3,\n  \"rows\": 2\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 result of recurring billing request. Possible values are: Approved, Error, or Declined.\"\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=\\\"12345678\\\";\\n $res=$client->enableCustomer($token, $custnum);    \\n }\\ncatch(SoapFault $e) {\\n echo \\\"soap fault: \\\" .$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 //Set CustNum for the Customer that you want to enable\\n BigInteger CustNum = new BigInteger(\\\"12345678\\\");\\n client.enableCustomer(token, CustNum);\\n} catch (Exception e) {\\n   System.out.println(\\\"Soap Exception: \\\" + e.getMessage());\\n}\",\n      \"language\": \"http\"\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 response As Boolean\\n       response = client.enableCustomer(token, custNum)\\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           Boolean response;\\n           try\\n           {\\n               response = client.enableCustomer(token, custNum);\\n               if (response)\\n               {\\n                   MessageBox.Show(string.Concat(\\\"Succesfull\\\"));\\n               }\\n               else MessageBox.Show(string.Concat(\\\"Error!\\\"));\\n           }\\n           catch (Exception err)\\n           {\\n               MessageBox.Show(err.Message);\\n           }\",\n      \"language\": \"css\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"enablecustomer","type":"basic","title":"enableCustomer"}
Enable recurring billing for a customer specified by CustNum. [block:api-header] { "type": "basic", "title": "Description" } [/block] This method allows you to begin a recurring billing cycle for an individual customer using their CustNum (unique customer number assigned by the gateway) as a reference. If you have lost or cannot remember the customer's CustNum, use the [searchCustomerID](/docs/searchcustomerid) method to retrieve it. The recurring billing cycle can begin on any date you choose and can be set to any of the following cycles: Daily, Weekly, Bi-Weekly (every 2 weeks), Monthly, Bi-Monthly (every 2 months), Quarterly, Bi-Annually (every 6 months), and Annually. You can also set the start and end dates, amount to be charged, and the total number of transactions for the recurring billing cycle. Once a customer has been added to a recurring billing cycle, you can monitor and change the recurring billing settings from within the merchant console. You can disable a customer's recurring billing cycle at any time using the [disableCustomer](/docs/disablecustomer) method. For more information about recurring billing, please refer to the support documentation in the merchant console. [block:api-header] { "type": "basic", "title": "Syntax" } [/block] boolean **enableCustomer** ( [ueSecurityToken](/docs/uesecuritytoken) Token, integer CustNum ) [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." }, "cols": 3, "rows": 2 } [/block] [block:api-header] { "type": "basic", "title": "Return Value" } [/block] [block:parameters] { "data": { "0-0": "boolean", "0-1": "Returns result of recurring billing request. Possible values are: Approved, Error, or Declined." }, "cols": 2, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] ## PHP [block:code] { "codes": [ { "code": "<?php\ntry {\n $custnum=\"12345678\";\n $res=$client->enableCustomer($token, $custnum); \n }\ncatch(SoapFault $e) {\n echo \"soap fault: \" .$e->getMessage();\n }\n?>", "language": "php" } ] } [/block] ## Java [block:code] { "codes": [ { "code": "try {\n //Set CustNum for the Customer that you want to enable\n BigInteger CustNum = new BigInteger(\"12345678\");\n client.enableCustomer(token, CustNum);\n} catch (Exception e) {\n System.out.println(\"Soap Exception: \" + e.getMessage());\n}", "language": "http" } ] } [/block] ## Visual Basic (.Net) [block:code] { "codes": [ { "code": "Dim custNum As String\n custNum = \"103125\"\n Dim response As Boolean\n response = client.enableCustomer(token, custNum)\n MsgBox(response)", "language": "c" } ] } [/block] ## C Sharp (.Net) [block:code] { "codes": [ { "code": "string custNum = \"89147\";\n Boolean response;\n try\n {\n response = client.enableCustomer(token, custNum);\n if (response)\n {\n MessageBox.Show(string.Concat(\"Succesfull\"));\n }\n else MessageBox.Show(string.Concat(\"Error!\"));\n }\n catch (Exception err)\n {\n MessageBox.Show(err.Message);\n }", "language": "css" } ] } [/block]