ViaJcart - User Manual - Chapter 9 - Real Time Credit Cart Processing

User Manual

Chapter 9 - Real-Time Credit Cart Processing

Introduction:

You can validate and process credit cards in real-time with 2.0 version. You can also allow downloading files from your server after order was processed if you sell graphical images, music, or software. You have to have Merchant account and pay monthly fee for this service. For example: You have to open an account with EMS 2000 at www.ems2000.com

They offer the lowest prices for credit card processing for small business. In addition, your server must be able to run Perl scripts in order for this to work (CGI). You will need to change and upload JSCRT.pl and JSCCCV.pl scripts.

Since most on-line credit card processing services on Internet have HTML Form interface, the ViaJCart will use the Browser to submit the credit card form. The best way is to try our Demo to see how it all works.

We supply you with scripts that will work with Securepay or Authorize.Net processing services.

How to make Java Shopping Cart process credit cards:

SecurePay:

Setup an account with EMS 2000. They will create a new directory for you on their server and provide this name to you.
Make changes in the JSCRTsp.pl script. All you need to do is to specify directory name that was assigned to you.
For example: change $URL = "https://www.securepay.com/yourdir/final.cfm" to $URL = "https://www.securepay.com/MyCompanyDir/final.cfm". The MyCompanyDir should be directory name that they created for you.

Upload JSCRTsp.pl in ASCII format into your cgi-bin directory of the secure server SSL. Make it executable by specifying chmod 755.

Change the JSC.ini file to use this script.
Change SSLURL=* to SSLURL=https://www.yourdomainname.com/cgi-bin/JSCRTsp.pl.

Make changes in the JSCCCV.pl script.
Change $Dir="/vssd/" to $Dir="/MYCompanyDir/". The MyCompanyDir should be directory name that EMS 2000 created for you.

Upload this script in ASCII format into your cgi-bin directory of your server. It should NOT be on SSL server.

Update securepay.html page with the thank you messages. The EMS 2000/Securepay will link to this page when credit card processes successfully in your root directory. It should say something like this: Your order was processed. Please go back to Java shopping cart and click [CONTINUE] button. Thank you. Also, make sure to include a link to your home page.

AuthorizeNet:

Open an account with Authorize Net

Change your Authorize Net merchant properties to point to http://www.yourdomainname.com/cgi-bin/JSCUID.pl in the POST Mode. Read Authorize Net documentation for more details.

Change JSCRTa.pl script. Change login id to your id provided by Authorize Net.

Change your Authorize Net merchant properties to require NAME and CUSTID fields only. Read Authorize Net documentation for more details.

Upload JSCRTa.pl script in ASCII format into your cgi-bin directory of the secure server SSL. Make it executable by specifying chmod 755.

Change the JSC.ini file to use this script.
Change SSLURL=* to SSLURL=https://www.yourdomainname.com/cgi-bin/JSCRTa.pl.

Upload JSCUID.pl script to your cgi-bin directory in ASCII format.

Create new directory on the same level as your cgi-bin directory with the name of "uid". It must have read/write access for everyone.

Make changes in the JSCCCV.pl script.
Change $Host=www.yourdomainname.com to your name.

Upload this script in ASCII format into your cgi-bin directory of your server. It should NOT be on SSL server.

The Customer will not be able to complete the order until the credit card was validated and processed.

Script file name extension:

You can specify your own file name extension for Perl scripts that is required by your provider. The cart will use the same file extension for all scripts taken from CGIscript parameter in the JSC.ini file.

If you have CGIscript=/cgi-bin/JSCCGI.pl all other scripts will have .pl extension. However, if you specify CGIscript=/cgi-bin/JSCCGI.cgi all other scripts will have .cgi extension as well. Some providers do not allow the use of .pl extension and you must use .cgi

How to enable Download feature:

If you are selling your products in electronic/digital form, you can allow for immediate download after credit card was approved. Create zip files for each download.

You will need to create password-protected directory for each product that you will allow to download. You need to know how to setup .htaccess file and passwords that it uses.

Each directory name MUST match the Item number that you have in the catalog.

Create download.htm page in each directory. It must have a link to the zip file for this item.

The UserID must be the same as Item Number when you create .htaccess and passwords files. The password should be different for each item.

Specify password for each item in the last field on each line in the catalog

Use Decrypt utility to decrypt passwords for each item before uploading.

Point to download directory in the JSC.ini by changing DownLoadURL parameter. DownLoadURL=http://www.yourdomainname.com/downloads/

After successful order placement, the customer will receive an email receipt with URL, User ID, and Password for items that he purchased.

Example:

URL: http://www.yourdomainname.com/downloads/item001/download.htm

Userid: item001
Password: xyzabc012

To disable this feature use DownLoadURL=*

next

Chapter 1 - Installation
Chapter 2 - JSC.ini control file
Chapter 3 - Menu file creation
Chapter 4 - Catalog files
Chapter 5 - Checking out process
Chapter 6 - Order; Encryption/Decryption process
Chapter 7 - ViaJCart Customization with JSCStrings.ini
Chapter 8 - Audio Setup
Chapter 9 - Real-Time Credit Card Processing
Chapter 10 - Troubleshooting
Chapter 11 - Upgrade From 1.x to 2.x