The CCBill Background Post System permits CCBill merchants to pre-fill customer information and send variables to CCBill through the Sign Up Form . Optionally, merchants can capture CCBill’s returned variables through the Approval Post URL and/ or a Denial Post URL. The information contained within the Background Post System documentation is written for Programmers, Technicians and other individuals with advanced programming skills.
The CCBill System is capable of passing back Approval Post URL, Denial Post URLs, and other variables sent to the Signup Form (credit card and bank account details are excluded) provided they are entered in the Modify Subaccount > Advanced page of the CCBill Admin Portal.
Refer to topic Variables List for a list and description of the Background Post variables. The variable names must be entered exactly as shown to receive the information properly.
Once the Approval and/or Denial or Post URLs have been entered into CCBill’s system, all the Background Post variables and the custom variables will be passed to the URLs you specified and can capture the returned variables with a script configured to receive Form Post information.
The Approval Post URL or Denial Post URL should point to a script such as CGI, PHP, ASP, etc.
For Example:
Post URL is as follows: http://www.yourwebsite.com/cgi-bin/your_script.cgi
The script should be programmed to receive and parse the information passed from CCBill according to your program language specifications. The returned values may be used for any purpose (e.g., After receiving the values, write them to a database for record keeping or pass them to another script.).
An example of a CCBill variable is customer_fname, which represents the customer’s first name. The variable will be originally sent from the CCBill Signup Form as customer_fname. If using a CGI script, the value might be parsed as $cust_first_name = param("customer_fname"). Please be aware that the variable name $cust_first_name can be any name chosen. The Pass Back variable as customer_fname must be specified to properly receive the information.
Please refer any questions you have concerning this type of code to a qualified programmer.
CCBill’s Sign Up Forms are capable of being pre-filled, as well as additional variables may be passed into CCBill’s system. This allows you to prefill the Sign Up Form or execute Admin Portal actions. Refer to topic Variables List for a list and description of the Background Post variables.
To pre-fill the Sign Up Form or execute Admin Portal actions:
Custom variables may be passed in; for example, VariableName and VariableName2. To pass in custom variables, add them in between the form tags of the HTML code to load the Sign Up Form.
Example: (Passing Custom Variables to Sign Up Form)
<form action='https://bill.ccbill.com/jpost/signup.cgi' method=POST> <input type=hidden name=clientAccnum value='900000'> <input type=hidden name=clientSubacc value='0000'> <input type=hidden name=formName value='7cc'> <input type=hidden name=VariableName value=VariableValue> <input type=hidden name=VariableName2 value=VariableValue2> <input type=submit name=submit value='Join Now'> </form>
You will need to rename the custom variables in accordance to how they will be defined. The values will be sent to the Sign Up Form as extra variables.
If you encounter problems, contact merchantsupport@ccbill.com for assistance. You do not have to install CCBill's Sign Up Form on your site. You only have to add the HTML code created in the Generate HTML area to the location on your website where you want to load the Sign Up Form.
Example: (Passing Static Variables)
The examples listed below show the following HTML code: Sign Up Form and Execute Admin Portal Action. Keep in mind that the variables shown in the examples represent static variables.
<form action='https://bill.ccbill.com/jpost/signup.cgi' method=POST> <input type=hidden name=clientAccnum value='900100'> <input type=hidden name=clientSubacc value='0000'> <input type=hidden name=formName value='8ck'> <input type=hidden name=allowedTypes value='0000005835,0000000265,0000007444'> <input type=hidden name=subscriptionTypeId value='0000007444' > <input type=hidden name=email value='custemail@website.com'> <input type=submit name=submit value='Join Now'>
<A HREF=https://bill.ccbill.com/jpost/signup.cgi?clientAccnum=900100&clientSubacc=0000&formName=8ck &allowedTypes=0000005835,0000000265,0000007444&subscriptionTypeId=0000007444 &email=youremail@website.com>Join Now</A>
You may add the HTML for a button or link to the Form, such as writeCache, which executes an Admin Portal action. The HTML code for a button or link to load the Sign Up Form will look like:
form action='https://bill.ccbill.com/jpost/signup.cgi' method=POST> <input type=hidden name=clientAccnum value='900100'> <input type=hidden name=clientSubacc value='0000'> <input type=hidden name=formName value='8ck'> <input type=hidden name=allowedTypes value='0000005835,0000000265,0000007444'> <input type=hidden name=subscriptionTypeId value='0000007444' > <input type=hidden name=writeCache value='1'> <input type=submit name=submit value='Join Now'>
<A HREF=https://bill.ccbill.com/jpost/signup.cgi?clientAccnum=900100&clientSubacc=0000 &formName=8ck&allowedTypes=0000005835,0000000265,0000007444&subscriptionTypeId=0000007444 &writeCachc=1>Join Now</A>
Another way of passing information to the CCBill Sign Up Form is through dynamic variables. You can use dynamic variables to prefill customer information. This will require you to create a form to suit your specific needs. The form will pass the information to another script written using CGI, PHP, ASP, etc., which contains your code to load the Sign Up Form.
The form you create will pass the customer inputted information to your button or Link code script page. This script will pass the variables to the CCBill signup Form when your customer loads it. After customer approval or denial, the information that you originally passed in will be sent to the Approval or Denial Post URL and ultimately to your script.
Example: (Passing Dynamic Variables)
print" <form action='https://bill.ccbill.com/jpost/signup.cgi' method=POST>"; print" <input type=hidden name=clientAccnum value='900100'>"; print" <input type=hidden name=clientSubacc value='0010'>"; print" <input type=hidden name=formName value='11cc'>"; print" <input type=hidden name=language value='English'>"; print" <input type=hidden name=allowedTypes value='0000000111,0000000318'>"; print" <input type=hidden name=subscriptionTypeId value='0000000318'>"; print" <input type=hidden name=customer_fname value='$cust_first_name'>"; print" <input type=submit name=submit value='Join Now'>"; print" </form>";
print"<A HREF=https://bill.ccbill.com/jpost/signup.cgi?clientAccnum=900100&clientSubacc=0010 &formName=11cc&language=English&allowedTypes=0000000111,0000000318&subscriptionTypeId=0000000318 &customer_fname=$cust_first_name> Join Now</A>";
Do not add any spaces to the link code example shown above.
Please refer any questions you have concerning this type of code to a qualified programmer.
A full list of variables, as well as Decline Codes and further information about the Background Post System is available in the Background Post User's Guide.