 |
|
|
 |
|
 |
|
|
|
|
 |
|
|
|
|
 |
|
|
|
|
 |
|
|
|
|
 |
|
|
|
|
 |
Free Bi-Monthly
Marketing Newsletter
|
|
|
|
|
|
 |
Merchants, Click
Below To Login
|
|
|
|
|
|
|
|
QuickCommerce WebLink HTML Help - (guidelines for linking a web site)
|
|
QuickCommerce WebLink HTML Help -
(guidelines for linking a web site)
|
Who is responsible for linking a web site with QuickCommerce?
|
Ultimately the responsibility of linking a web site with QuickCommerce belongs to the owner of the web site or whoever is responsible for the web site in general. QuickCommerce support personnel cannot be responsible for ensuring that a web site is programmed properly for use with QuickCommerce. Merchants that are unable to implement the HTML requirements for using QuickCommerce WebLink should consult with a local Internet web designer/programmer for assistance.
All basic Internet web sites are really a single or many HTML coded text files and graphics files that are linked together and stored on an Internet server. In order to use QuickCommerce WebLink, you must have a few additional lines of HTML code placed in the web page file that represents the final order page of a web site.
The following guidelines are intended to identify the QuickCommerce WebLink requirements and provide basic HTML code snippet examples of how to implement these requirements. Custom programming needs of a specific web site are beyond the scope of the QuickCommerce system and will NOT be addressed in this guide. Custom programming needs should be provided by an adequate Internet web designer/programmer.
|
WebLink Overview
|
There are two different ways to link a web site to QuickCommerce WebLink for real-time transaction processing:
OPTION 1: Link to the QuickCommerce WebLink secure payment form - (for merchants who do not have a secure server or for merchants who prefer to use the QuickCommerce payment form) The flow of the links is as follows:
Your web site, then to..
QuickCommerce WebLink secure payment form, then to..
QuickCommerce Secure transaction gateway, then to..
QuickCommerce WebLink transaction receipt page, then ..
Back to your web site
OPTION 2: Link directly to the QuickCommerce secure transaction gateway - (only for merchants who have a secure server AND are capable of creating/programming their own payment form) The flow of the links is as follows:
Your web site, then to..
QuickCommerce Secure transaction gateway, then to..
QuickCommerce WebLink transaction receipt page, then ..
Back to your web site
NOTE: For the purposes of this section, a secure server is defined as a web server that has installed and is running at least SSL 2.0 (Secure Socket Layer) and has a verifiable secure server digital certificate from a recognized certificate authority.
Before starting to implement the following requirements, please consider that the QuickCommerce payment form and receipt page are provided by the QuickCommerce system and can be customized only in certain ways. The system has been designed to appeal to the widest variety of merchants as is possible. A list of what you can change about the QuickCommerce payment form and receipt page is found in the section entitled "Edit configuration" later in this guide.
You must have a moderate understanding of HTML in order to fully exploit the features of QuickCommerce WebLink. Although it is true that the following snippets of HTML code can be copied and pasted directly into a web site and it would "work", it is not likely that all of the specific needs you have with your web site will be met simply by copying and pasting this code. Merchants that are unable to achieve the custom look and feel they want on their own should consult with a local Internet web designer/programmer for assistance.
|
How to link a web site to the QuickCommerce WebLink secure payment form
|
If you have not read the WebLink overview above, please read it NOW before continuing.
|
Requirements for your web site
|
At the very minimum, you web site
must do the following in order to be linked properly with the QuickCommerce WebLink secure payment form:
1. Your web site must produce a total credit card sale or electronic check amount that is to be authorized by the QuickCommerce system. The QuickCommerce code samples below do NOT demonstrate how to calculate totals; calculating a total amount is not part of the QuickCommerce system, and usually requires script programming in your web site.
2. Your web site must pass at least the total AMOUNT and the QuickCommerce LOGIN ID associated with your QuickCommerce account to QuickCommerce. The code samples below demonstrate this.
3. Any other fields, such as invoice, customer ID, name, address, E-mail, etc.. that are defined as "required" on the QuickCommerce system by you or your merchant provider must also be passed. The code samples below demonstrate this.
|
Allowed Fields
|
You can pass any of the following fields to the QuickCommerce system. To work properly, the fields must be named exactly as the are named here:
LOGIN (required)
AMOUNT (required)
The rest of the fields below may or may not be required, depending on the account configuration.
TYPE ( either "NA" for Normal Authorization or "AO" for Authorization Only. The system will default to "NA")
AMOUNT (required)
INVOICE
DESCRIPTION
CUSTID
NAME
ADDRESS
CITY
STATE
ZIP
COUNTRY
PHONE
FAX
EMAIL
USER1
USER2
USER3
USER4
USER5
USER6
USER7
USER8
USER9
USER10
|
Example One - Bare minimum requirements
|
The following HTML code snippet represents the bare minimum requirements:
The result of the above HTML code snippet on a web site is a simple button that is programmed to pass a total dollar amount to the QuickCommerce secure payment form. Obviously this represents the bare minimum, with no description, Customer ID, or Invoice - fields that are likely to be desired. Once the customer arrives on the QuickCommerce payment form, they will be prompted for payment information, name, address, city, state, zip, country, phone, fax, and E-mail.
|
Example Two - Suggested minimum requirements
|
The following HTML code snippet represents the suggested minimum requirements:
The result of the above HTML code snippet on a web site is a simple button that is programmed to pass a total dollar amount, invoice number, description, and customer id to the QuickCommerce secure payment form. Once the customer arrives on the QuickCommerce payment form, they will be prompted for payment information, name, address, city, state, zip, country, phone, fax, and E-mail.
|
Example Three - Using your own form and a custom USER1 field
|
The following HTML code snippet demonstrates how to use your own form to gather some of the information as well as a custom field prior to linking the QuickCommerce. Remember that in order for your fields to be passed to QuickCommerce properly, THE FIELD NAMES MUST BE NAMED CORRECTLY.
The result of the above HTML code snippet on a web site is two fields that prompt for Name (NAME) and special information (USER1) with a simple button that is programmed to pass a total dollar amount, invoice number, description, customer id, the name and special information to the QuickCommerce secure payment form. Once the customer arrives on the QuickCommerce payment form, they will be prompted for payment information, name, address, city, state, zip, country, phone, fax, and E-mail. Notice that even though you have passed the name to QuickCommerce, the QuickCommerce online payment form will still prompt the user for it, only this time, it will be pre-filled in since your web site passed it to the payment form. It is possible to prevent the user from editing a field on the QuickCommerce payment form that your web site has already passed to it. See the section entitled Edit Configuration below for details.
|
How to link a web site directly to the QuickCommerce Secure transaction gateway
|
If you have not read the WebLink overview above, please read it NOW before continuing.
|
Requirements for your web site
|
At the very minimum, your web site must do the following in order to be linked properly with the QuickCommerce Secure transaction gateway:
1. Your web site must produce a total amount that is to be authorized by the QuickCommerce system. The QuickCommerce code samples below do NOT demonstrate how to calculate totals; calculating a total amount is not part of the QuickCommerce system, and usually requires script programming in your web site.
2. Your web site must pass at least the total AMOUNT, the QuickCommerce LOGIN ID associated with your QuickCommerce account, the transaction TYPE, the transaction METHOD, the CREDIT CARD NUMBER, and EXPIRATION DATE to QuickCommerce. The code sample below demonstrates this.
3. Any other fields, such as Invoice, Customer ID, Name, Address, E-mail, etc.. that are defined as "required" on the QuickCommerce system by you or your merchant provider must also be passed. The code sample below demonstrates this.
|
Allowed fields
|
You can pass any of the following fields to the QuickCommerce system. To work properly, the fields must be named exactly as the are named here:
LOGIN (required)
AMOUNT (required)
TYPE (required - "NA" for Normal Authorization or "AO" for Authorization Only)
METHOD (required - "Visa", "MasterCard", "American Express", "Discover", "Diners", "JCB", or "ACH")
CARDNUM (only required for Credit Card transactions)
EXPDATE (only required for Credit Card transactions)
BANKNAME (only required for ACH/Electronic Check transactions)
ACCTNUM (only required for ACH/Electronic Check transactions)
ABACODE (only required for ACH/Electronic Check transactions)
The rest of the fields below may or may not be required, depending on the account configuration.
INVOICE
DESCRIPTION
CUSTID
NAME
ADDRESS
CITY
STATE
ZIP
COUNTRY
PHONE
FAX
EMAIL
USER1
USER2
USER3
USER4
USER5
USER6
USER7
USER8
USER9
USER10
|
Example One - Suggested minimum requirements
|
Linking a web site directly to the QuickCommerce WebLink transaction gateway should only be done if your web site is secure and you have adequate programming skills to create your own payment form! The following HTML code snippet demonstrates the suggested minimum requirements:
The result of the above HTML code snippet on a web site is a prompt for credit card information, name, and a simple button that is programmed to pass the required payment information, a total dollar amount, invoice number, description, name, and customer id to the QuickCommerce WebLink secure transaction gateway. If the transaction is authorized, the customer will arrive on the QuickCommerce transaction receipt page.
|
Configuring the QuickCommerce Transaction Receipt page
|
The QuickCommerce WebLink receipt page is displayed for every accepted transaction. In addition, QuickCommerce can E-mail a copy of the receipt to both you and your customer on your behalf. You can configure the receipt page the following ways:
- A single logo graphic can be added to the top of the receipt page
- A background graphic can be added or the background color can be changed
- Text and/or HTML can be added to the top of the receipt ("Header Text").
- Text and/or HTML can be added to the bottom of the receipt ("Footer Text")
- Text can be added to the top of the E-mail receipt ("E-mail Header Text")
- Text can be added to the bottom of the E-mail receipt ("E-mail Footer Text")
- The E-mail receipt to the customer can be disabled
- The E-mail receipt to the merchant can be disabled
To configure any of the above options, simply login to QuickCommerce and choose "Edit Configuration" from the Merchant Menu. Then, under WebLink option select the configuration options you need. If the "Edit Configuration" option is not available on your Merchant Menu, contact technical support using the "Merchant Support" feature on the Merchant Menu.
|
Configuring QuickCommerce to link or post back to your web site
|
Once you have successfully linked your web site to Quick Commerce WebLink, you may also want the Quick Commerce system to link back to your web site. QuickCommerce can be configured to link back to your web site 2 different ways, summarized here. One or both ways may be used.
OPTION 1:
Hyperlink from QuickCommerce receipt page back to your web site. (The customer must click the hyperlink to get back to your web site)
-OR-
HTTP Form Post method from QuickCommerce receipt page back to your web site.
(The customer must click the "continue" button to cause the form post back to your web site)
OPTION 2:
method from QuickCommerce transaction server to your web server. (The QuickCommerce server will "impersonate" a browser and cause the post back to your web site automatically each time a transaction is accepted. The QuickCommerce receipt page is displayed after the silent form post takes place) More notes below
...
To configure QuickCommerce to link back to your web site either of the 2 ways described above, simply login in to QuickCommerce and choose "Edit Configuration" from the Merchant Menu. Then, under WebLink options, you can specify the URL and link method for the QuickCommerce receipt page link and the URL for the HTTP silent form post if desired. If the "Edit Configuration" option is not available on your Merchant Menu, contact technical support using the "Merchant Support" feature on the Merchant Menu.
|
What field values are passed back during either form post?
|
Only certain of the allowed fields can be passed back to your web server during either form post. They are listed below:
DESCRIPTION
TYPE
AMOUNT
INVOICE
METHOD
CUSTID
NAME
ADDRESS
CITY
STATE
ZIP
COUNTRY
PHONE
FAX
EMAIL
USER1
USER2
USER3
USER4
USER5
USER6
USER7
USER8
USER9
USER10
|
|
|
|
