Recurring
The following is a case study for creating a simple recurring or subscription page hosted on eBizCharge's side and linked from your website that connects to eBizCharge for secure processing. This is a great starting off point for service fee merchants that want to accept a fixed dollar amount from the client through a payment form. Below you can download the necessary source code files. Edit the HTML source code with your favorite editor (Notepad, TextEdit, Dreamweaver) to input your source key and edit any of the templated text already there for you. Save the files in the original format. These files will need to be uploaded via a service such as FTP, or something similar, to your website. Once you've uploaded the files you can access them through the browser. Clicking on the button submits the form to eBizCharge and brings the customer to the secure payment area on eBizCharge's servers. The customer completes the payment process by entering their payment information. For information on editing eBizCharge's hosted paymet form click here.
The form uses the following fields to post to eBizCharge:
-UMkey - This is the source key that connects you as a valid merchant on our gateway (Required)
-UMcommand - This indicates the type of a transaction, sale. (Required)
-UMcustreceipt - This flags eBizCharge to send a customer receipt via email through a value of 'yes'.
-UMaddcustomer UMrecurring is deprecated - This flags eBizCharge to add this transaction as a customer record in Customers & Billing area of the Merchant Console.
-UMinvoice - This allows you to pass a numerical invoice number for record keeping. (Required)
-UMamount - A text box displayed for customer to enter a decimal (0.00) amount. (Required)
-UMbillamount - Sets the monetary amount to charge on each cycle. If this field is left blank the UMamount will be used instead. This is NOT the “initial” charge or “setup” charge, this is only the “recurring” charge. UMamount determines the initial charge.
-UMschedule - Determines the recurring billing schedule. Possible values are daily, weekly, biweekly, monthly, bimonthly, quarterly, biannually, or annually. (defaults to monthly)
-UMnumleft - Number of transactions remaining in recurring billing cycle. If the recurring billing should go on indefinitely, set this to *. (defaults to *)
-UMstart - Start date. Default is tomorrow. Must be entered in YYYYMMDD format. If set to UMstart=next the date of the next billing cycle will be used. For example if today is 1/10/2009 and UMschedule=monthly then UMstart will be set to 2/10/2009.
-UMdescription - A text box for any comments left by the donor
-UMcomments - Optional transaction comments field. Comments are displayed on the transaction details page.
-UMemail - A place for the donor to enter their email address for a confirmation receipt.
-Billing Fields - All the billing fields that will be transferred over to the secure payment form.
The form is not limited to only these fields. Others may be used. Please customize based on your preferences.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <title>Recurring Payment Form</title> </head> <body> <style type="text/css"> /*<![CDATA[*/ div.c6 {text-align: center} p.c5 {text-align: center} span.c4 {font-family: Verdana; font-size: 80%} span.c3 {font-family: Verdana} span.c2 {color: #FFFFFF; font-family: Verdana, Arial; font-size: 120%} span.c1 {color: #FFFFFF; font-family: Verdana, Arial; font-size: 200%} /*]]>*/ </style> </head> <body> <form action="https://www.ebizcharge.com/interface/epayform/"> <input type="hidden" name="UMkey" value="HBDy1XU40KsourceKeyHere7a5iOh2HP" /> <input type="hidden" name="UMcommand" value="sale" /> <input type="hidden" name="UMcustreceipt" value="yes" /> <input type="hidden" name="UMaddcustomer" value="yes"/> <div class="c6"> <table border="0" width="700" cellpadding="4" cellspacing="0"> <tr> <td bgcolor="#9999FF" width="692" colspan="2"> <strong><span class="c1">Subscribe to a recurring service fee</span></strong> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="692" colspan="2"> </td> </tr> <tr> <td bgcolor="#C4C7D4" width="692" colspan="2"> <span class="c3"><strong>Recurring Payment Details:</strong></span> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234"> </td> <td bgcolor="#F0F0F0" width="450"> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"> <span class="c4">Order Number:</span> </td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMinvoice" value="12345678" /> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"> <span class="c4">Initial / Down Payment Amount:</span> </td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMamount" value="0.00" /> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"> <span class="c4">Subscription / Recurring Payment Amount (if different from Initial):</span> </td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillamount" value="" width="250" /> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"> <span class="c4">Choose your schedule:</span> </td> <td bgcolor="#F0F0F0" width="450"> <select name="UMschedule"> <option value="daily">daily</option> <option value="weekly">weekly</option> <option value="biweekly">biweekly</option> <option value="monthly">monthly</option> <option value="bimonthly">bimonthly</option> <option value="quarterly">quarterly</option> <option value="biannually">biannually</option> <option value="annually">annually</option> </select> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"> <span class="c4">Number of Payments, "*" means indefinite:</span> </td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMnumleft" value="*" size="10" /> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"> <span class="c4">Start Date of Payments (YYYYMMDD format); If set to next, date of the next billing cycle will be used. If today is 1/10/2009 and schedule is monthly then start date = 2/10/2009: </span> </td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMstart" value="next" /> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234"> </td> <td bgcolor="#F0F0F0" width="450"> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"> <span class="c4">Description of Service:</span> </td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMdescription" value="Service Fee"> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"> <span class="c4">Comments:</span> </td> <td bgcolor="#F0F0F0" width="450"> <textarea name="UMcomments" cols="40" rows="5"> Enter your comments here... </textarea> <br /> </td> </tr> <tr> <td bgcolor="#C4C7D4" width="692" colspan="2"> <font face="Verdana"><b>Billing Information:</b></font> </td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">Company Name:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillcompany" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">First Name:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillfname" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">Last Name:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbilllname" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">Address:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillstreet" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">Address Line 2:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillstreet2" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">City:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillcity" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">State:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillstate" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">Zip:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillzip" size="11" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">Country:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillcountry" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">Phone Number:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMbillphone" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="234" align="right"><font face="Verdana" size="2">Email Address:</font></td> <td bgcolor="#F0F0F0" width="450"> <input type="text" name="UMemail" size="28" value=""></td> </tr> <tr> <td bgcolor="#F0F0F0" width="692" colspan="2"><font face="Verdana" size="2"> </font></td> </tr> <tr> <td bgcolor="#F0F0F0" width="692" colspan="2"> <p class="c5"> <input type="image" src="ebizchargesecurebuttongray3.gif" value="Continue to Payment Form" /> </p> <hr /> </td> </tr> </table> </div> </form> </body> </html>