Ecommerce for Cyrano
by
This is the step-by-step document summarizing how to set up the ecommerce for cyranosciences, in which I incorporated arsdigita documents as well as related information found at cybercash web site.
The Big Picture
To accept payments online, an internet storefront (ecommerce module from aD allows you to build a storefront easily, and shoppe module can provide you with a simple version of it), a merchant bank account (for a list of financial institution you can get your account from, go to http://www.cybercash.com/cashregister/solutions_financial.html, First Data Corp. (FDC), Wells, NDCeCommerce, Vital, Nova and Paymentech support AVS) and an internet payment solution are needed.
Customization of the Storefront built with ecommerce module
Please readhttp://www.arsdigita.com/doc/ecommerce-setup.html first.
Add product to your storefront
You need to collect the following product information:
- Product Name
- SKU or product_id
- Product Category
- Stock Status (Out of Stock, In Stock, Usually Ships within 24 hours, etc.)
- Description
- Search Keywords (as many keywords you can think of to allow your product easily be found)
- Picture
- Color Choices
- Size Choices
- Style Choices
- URL for more product-related information
- Regular Price (special price for promotion or certain customer category) if you have)
- Shipping Price
- Weight, etc.
Go to https:///admin/ecommerce (e.g.cyrano store) and add products following the instructions
Merchant registration at Cybercash
Cybercash is the internet payment solution we used, in order to use their service, you need to register a cybercash account and download the software MCK to interface your storefront with Cybercash Register.
You need to provide the following information:
- your business legal name and the store name
- your address, telephone number, and contact person information
- the store's URL
- the name of the web integration company that you use, and the contact person at that company
- the name of the comapny that hosts your store and the contact person at that company
- your store configuration information, including the operating system type and version, the web server software, and the storefront software
- the payment service that you want to use (cybercash can provide transaction either by credit card, the CashRegister 3 Credit Card Service, or by check, the InstaBuy Express Checkout Service).
Instruction:
Go to http://amps.cybercash.com and follow the instructions to register as a new merchant. In general, you need to do the following:
- enter email address and password
- create a cybercash ID(CCID) by entering your business name
- fill out the form \"General Merchant Information\"
- grant development partner access
- choose the appropriate service
- review and accept the Cybercash Service Agreement
- enter password for the payment administration name
- identify your platform and download related documentation and the appropriate Merchant Connection Kit(MCK) software (e.g. install-mck-3.2.0.6-solaris-sparc.Z).
At this point, you have complete the registration and the confirmation is returned with some information(MCK Configuration Settings: CyberCash ID, Merchant Key, HASH_SECRET) included (Note: you need to save this page).
Unpack and Install MCK at your merchant storefront
- Unzip MCK software using the following command:
uncompress install-mck-3.2.0.6-sparc-sun-solaris2.6.Z
(Note: file install-mck-3.2.0.6-sparc-sun-solaris2.6 will be generated after the command)
- Change permissions to enable execute permissions using the following command:
chmod +x install-mck-3.2.0.6-sparc-sun-solaris2.6
- Run the installer:
./install-mck-3.2.0.6-sparc-sun-solaris2.6
- Enter 1 to accept the terms of the license agreement
Note: Diretory mck-3.2.0.6-sparc-sun-solaris2.6 will be created in the current path after the command, under which you will find files CHANGES, LICENSE, README, configure and configure.log and directories Install, c-api, master-merchant and perl-api.
- Change Directory and Run the configuration:
cd mck-3.2.0.6-sparc-sun-solaris2.6
./configure
- Respond to the installation prompts:
- the script language you want to use (either C or PERL)
- CyberCash ID (from CyberCash registration system, see above \"Merchant Registration at CyberCash\" section)
- hash secret (from CyberCash registration)
- store name
- customer service phone number
- merchant key (from CyberCash registration)
- the root URL of your secure web server in the format https://:/ (if you are using default port 443, enter https://dev.cyranosciences.com; if you are using a port other than the default such as 8080, enter https://dev.cyranosciences.com:8080)
- the corresponding full UNIX directory path to the root directory of your secure web server (e.g. /web/cyrano-dev/www/)
- whether you want to accept payments from the Microsoft Wallet
- whether you intend to sell soft goods
- whether you want to review your settings (for yes type y)
- whether you want to install the configuration files (type y).
Directories will be created under the UNIX path for your web server
Note: files and directories with * are generated when you chose to have C as script language
Download and Install the insterface to CyberCash for AOLServer (cybercash-0.1.tar.gz)
- Go to http://www.arsdigita.com/free-tools/cybercash-0.1.tar.gz for software download
- Unpack by typing the following command:
tar -xzvf cybercash-0.1.tar.gz
Directory \"cybercash\" containing files \"README\" \"Makefile\" \"cybercash.c\" will be generated
- Edit the following parameters at the top of the Makefile
Example:
# AOLserver directory
NS_HOME=/home/aol30
# Directory where MCK was unpacked
MCK_HOME=/web/cyrano-dev/cybercash/mck-3206
# Location of the merchant_conf file.
CONFFILE=/web/cyrano-dev/cybercash/mck-3206/cyranotest-60-stg/conf/merchant_conf
If there are more than one CyberCash service under the same AOLserver, change these parameters as well:
-
MODULE=cybercash.so
to
MODULE=cybercash-yourservername.so
-
install: cybercash.so
cp cybercash.so $(NS_HOME)/bin
to
install: cybercash.so
cp cybercash.so $(NS_HOME)/bin/$(MODULE)
- Run 'make' and 'make install'
Edit your service AOLserver nsd.ini and Restart your server
Testing
- The connection reaches the CyberCash CashRegister
After you have finished merchant registration at CyberCash, your account will be in test mode by default, which means that none of the transactions will take effect on your credt card or checking account.Since there are cgi scripts used in the package, modify nsd.ini adding the cgi section and restart your server
[ns/server/cyrano-dev/cgi]
Map=GET /*.cgi
Map=POST /*.cgi
- Go to the URL https:////mck-htdocs/test-mck.html (e.g. http://dev.cyranosciences.com/cyranotest-60/mck-htdocs/test-mck.html), follow the instruction and make a test order online using the following test card numbers, which are configured for the CyberCash test-certification gateway and real credit card number will result in a failure message:
Visa 4111111111111111
Mastercard 5555555555554444
AmericanExpress 378282246310005
Discover 6011111111111117
- go to the CyberCash admin page located at http://cr.cyberecash.com and login as admin (you can find your admin username and password on the confirmation page you save from CyberCash registration or under the merchant configuration section of your account if you login the CyberCash registration server at http://amps.cyberecash.com, query the order status from the admin page and you should be able to view the entry of your new order.
- use the administration server at http://cr.cyberecash.com to do an AUTH, VOID and a RETURN, confirm from your storefront.
- The connection from the storefront built with ecommerce module and the CyberCash CashRegister
- Go to the URL of your storefront (e.g. http://dev.cyranosciences.com/ecommerce) and order a gift certificate online
- go to the CyberCash admin page to confirm the entry of your order.