{"_id":"5632a5ec49e16d0d001224c5","project":"55b933b3146ef121002158d3","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"},"category":{"_id":"5632a5e749e16d0d00122444","pages":["5632a5ec49e16d0d001224bd","5632a5ec49e16d0d001224be","5632a5ec49e16d0d001224bf","5632a5ec49e16d0d001224c0","5632a5ec49e16d0d001224c1","5632a5ec49e16d0d001224c2","5632a5ec49e16d0d001224c3","5632a5ec49e16d0d001224c4","5632a5ec49e16d0d001224c5","5632a5ec49e16d0d001224c6","5632a5ec49e16d0d001224c7","5632a5ec49e16d0d001224c8","5632a5ec49e16d0d001224c9","5632a5ec49e16d0d001224ca","5632a5ec49e16d0d001224cb","5633bab59c607719001b86a1","5633bcbac49a7c19001fd0a6","5633befcc49a7c19001fd0a9","5633c585b904a10d0032f864","5633d7547b56ae0d0025a062","5633d7e87b56ae0d0025a066","5633d85435355017003ca3c8","5633da507e9e880d00af1a28","5633daa3fa71f30d00ba74ab","5633e1f87e9e880d00af1a3f","5633e323fa71f30d00ba74b9","5633e3aa7b56ae0d0025a072","5633e4c6737ea01700ea3276"],"project":"55b933b3146ef121002158d3","version":"5632a5e549e16d0d00122443","__v":14,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-31T23:12:47.262Z","from_sync":false,"order":0,"slug":"epayment-form","title":"ePayment Form"},"__v":0,"user":"55b932ba8fd1a02b00f496c8","githubsync":"","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-03T18:34:58.695Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"This code will allow you to use Javascript to make fields required, rather than the source key settings. You may want to use this rather than the built-in required fields settings as an alternate way of requiring those fields to be filled out. The main difference between this and our built-in required fields handling is that this will ensure fields are filled out before the customer leaves the page - some web browsers will erase all data if the customer leaves the page.\n\n1. Log into your eBizCharge merchant gateway. Go to “Settings”, then “Source Keys”. Select the source key you are using and click “Edit”. Click “Edit Customization to Epay Form”.\n2. Insert this code into the document head:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<script>\\nfunction verify()\\n{\\nvar themessage = \\\"Please complete the following fields: \\\";\\nif (document.epayform.UMname.value==\\\"\\\") {\\nthemessage = themessage + \\\" - Cardholder Name\\\";\\n}\\n//alert if fields are empty and cancel form submit\\nif (themessage == \\\"Please complete the following fields: \\\") {\\ndocument.epayform.submit();\\nreturn true;\\n}\\nelse {\\nalert(themessage);\\nreturn false;\\n}\\n}\\n</script>\",\n      \"language\": \"javascript\"\n    }\n  ]\n}\n[/block]\n1. You can make as many fields required as you want. To make a field required, repeat this section of code:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"if (document.epayform.UMfield.value==\\\"\\\") {\\nthemessage = themessage + \\\" - Name Of Field\\\";\\n}\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]\n1. Scroll down to the bottom of the form and look for this line:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<input type=\\\"submit\\\" name=\\\"submitbutton\\\" value=\\\"Process Payment &gt;&gt;\\\">\",\n      \"language\": \"html\"\n    }\n  ]\n}\n[/block]\n2. Change it to read:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<input type=\\\"submit\\\" name=\\\"submitbutton\\\" value=\\\"Process Payment &gt;&gt;\\\" onclick=\\\"return verify();\\\">\",\n      \"language\": \"html\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"required-field-prompts","type":"basic","title":"Required Field prompts"}

Required Field prompts


This code will allow you to use Javascript to make fields required, rather than the source key settings. You may want to use this rather than the built-in required fields settings as an alternate way of requiring those fields to be filled out. The main difference between this and our built-in required fields handling is that this will ensure fields are filled out before the customer leaves the page - some web browsers will erase all data if the customer leaves the page. 1. Log into your eBizCharge merchant gateway. Go to “Settings”, then “Source Keys”. Select the source key you are using and click “Edit”. Click “Edit Customization to Epay Form”. 2. Insert this code into the document head: [block:code] { "codes": [ { "code": "<script>\nfunction verify()\n{\nvar themessage = \"Please complete the following fields: \";\nif (document.epayform.UMname.value==\"\") {\nthemessage = themessage + \" - Cardholder Name\";\n}\n//alert if fields are empty and cancel form submit\nif (themessage == \"Please complete the following fields: \") {\ndocument.epayform.submit();\nreturn true;\n}\nelse {\nalert(themessage);\nreturn false;\n}\n}\n</script>", "language": "javascript" } ] } [/block] 1. You can make as many fields required as you want. To make a field required, repeat this section of code: [block:code] { "codes": [ { "code": "if (document.epayform.UMfield.value==\"\") {\nthemessage = themessage + \" - Name Of Field\";\n}", "language": "csharp" } ] } [/block] 1. Scroll down to the bottom of the form and look for this line: [block:code] { "codes": [ { "code": "<input type=\"submit\" name=\"submitbutton\" value=\"Process Payment &gt;&gt;\">", "language": "html" } ] } [/block] 2. Change it to read: [block:code] { "codes": [ { "code": "<input type=\"submit\" name=\"submitbutton\" value=\"Process Payment &gt;&gt;\" onclick=\"return verify();\">", "language": "html" } ] } [/block]