web design and hosting
features and pricing my account customer support about ICG Link, Inc. contact ICG Link, Inc.

NetMerchant billing.html
NetMerchant billing.html

The default billing.html template for NetMerchant will produce a billing information page that looks something like the one in the example. You can use the setup tool to copy the default billing.html template file to your www/data/shopname folder. In order to create a working version of billing.html you must edit at least one item.

You must change the name testshop to your shop name. It occurs in only one place in the default template. Obviously you can also change any colors to fit your needs and you can fit this shop into a design you already have for your site by adding header and footer information around the basic code provided.

COMMENT TAGS: Like all the NetMerchant templates, this template uses html comment tags to get information from NetMerchant and display it for the user. Study the tags a bit and you will see how they work.

IMPORTANT IMAGE LOCATION NOTE: billing.html uses images from your sweb folder. Any images you call here should be from a secure folder (somewhere in your sweb folder). You can use the exact images shown in the example for single pixel images if you like. They are provided for your convenience. As with all html files located in your /data folder, you must use a full URL to locate an image.

OPTIONAL FIELDS : NetMerchant identifies special billing related information by looking for the prefix "bill" before the field name (eg. <INPUT NAME="billname">). Besides this regular billing information, you may add any other form field to this template (eg, input, checkbox, option list, etc). Field names with the prefix "bill" are required (meaning the user has to fill the field out: eg. <INPUT NAME="billemail">). An optional field should begin with v_. (eg. <INPUT NAME="v_birthday">) Any field without a prefix will be ignored by NetMerchant. Make certain you have put bill (or ship for the shipping template) or v_ in front of any form fields you use. If you use <select name="cardyear"><! CARDYEAR_OPTIONS></select> a list of 15 years will be generated starting with the current year and the system will remember the value for cardyear as visitors use the cart.

Important Note: Authorize.net requires first and last name while Quick Commerce requires a single name field.

PAYPAL: In order to use PayPal with NetMerchant, you must contact support to have a paypal.conf file added to your /cgi-bin/username folder. That file contains the email address that corresponds to your PayPal account.

You must also have a PayPal account with Instant Payment Notification turned on. While logged in to PayPal, this is found by clicking the "My Account" tab. Then click on the "Profile" link. Click "Instant Payment Notification Preferences" in the right hand column and click the "Edit" button. Check the box next to "Instant Payment Notification integrates PayPal payment notification...." Then enter the following URL in the box under "Notification URL"


where yourdomain.com is your domain without the www and yourcartname is your NetMerchant cart name.

In addition, you will have to call your mail, log, and SQL templates. Unlike a standard transaction, where these are hidden fields, the transaction from PayPal results from a call from PayPal, so there is no way to embed hidden fields. Instead, a file called "paypal.conf" (not to be confused with the file of the same name in cgi-bin/user that holds the paypal email address) is created and put in your www/data/cartname folder. An example of the contents of this file is as follows:
f_email     notify.email,verify.email
f_text      log.file,full.file,item.file,order.file
f_mysql     orders,order_items
f_remember  yes
As a final step, add the code:


to your NetMerchant billing template to present the paypal button as a payment option to buyers. The visitor's shipping information will already have been collected if you are using our standard templates. When the user clicks on the PayPal button, the visitor is taken to the PayPal web site to complete the financial portion of the transaction. Once they have successfully completed the PayPal payment, they MUST click on the "CONTINUE" button on PayPal's site in order to be passed back to us and have the order officially logged. If they do not click this button their payment WILL be processed through paypal, but NetMerchant WILL NOT record the transaction on our side. PayPal will always return the buyer to the 'receipt.html' page by way of a special payment.pl script called paypal_payment.pl The following two tags can be included on the receipt template if desired... They can also (and perhaps more usefully) be used in the log templates so pending orders can be withheld until completion of payment:

<! PAYPAL_STATUS> is replaced by "COMPLETED" or "PENDING" or "DECLINED", etc.

< PAYPAL_MSG> is replaced by whatever text message paypal might send.


Both Authorize.net and Quick Commerce can accept payment by check. If you plan to use either one of these services to collect payment by check, be sure to collect the checking account number in a field named billcheckacct and the bank routing number in a field called billroutingnum.
ICG Link, Inc. 7003 Chadwick Drive, Suite 111, Brentwood, TN 37027