" WebLink Support Guide "


Contents

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.

    Basic HTML WebLink programming is available through QuickCommerce Premium Support for a fee. Click HERE for more information or to request premium support.

    Back to the top

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.

    Back to the top

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.

    Back to the top

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.)
      AMOUNT (required)
      INVOICE
      DESCRIPTION
      CUSTID
      NAME
      ADDRESS
      CITY
      STATE
      ZIP
      COUNTRY
      PHONE
      FAX
      e-mail
      USER1
      USER2
      USER3
      USER4
      USER5
      USER6
      USER7
      USER8
      USER9
      USER10

    Back to the top

Example - Form requirements
    The following HTML code demonstrates how to use a form to gather information to be passed to QuickCommerce. Remember that in order for your fields to be passed to QuickCommerce properly...

    THE FIELD NAMES MUST BE NAMED CORRECTLY!

    The result of including only the first few fields below, is a simple button that is programmed to pass a single dollar amount to the QuickCommerce secure payment form. Obviously this represents the bare minimum. Once the customer arrives at the payment form, they will be prompted for payment information, name, address, city, state, zip, country, phone, fax, and E-mail.

    <FORM method="POST" action="https://www.quickcommerce.net/scripts/qc25/WebLink.asp">
       <INPUT type="HIDDEN" name="LOGIN" value="your login id here">
       <INPUT type="HIDDEN" name="CUSTID" value="customer id here">
       <INPUT type="HIDDEN" name="AMOUNT" value="total amount here">

     With the addition of the fields below, you can pass an invoice number and description to the QuickCommerce secure payment form. These fields can be generated by a script as long as the fields are named correctly.

       <INPUT type="HIDDEN" name="INVOICE" value="your invoice number here">
       <INPUT type="HIDDEN" name="DESCRIPTION" value="order description here">

     If you would like to prompt the user for additional information ("Name", "Special Information", or anything else), add additional form fields as below:

    Enter your Name:
       <INPUT type="TEXT" name="NAME" size="40" maxlength="40">

    Enter special info:
       <INPUT type="TEXT" name="USER1" size="40" maxlength="40">

    Other info:
       <INPUT type="TEXT" name="USER2" size="40" maxlength="40">


     Be sure to include a "SUBMIT" button and close your FORM.

       <INPUT type="SUBMIT" value="Click Here for Secure Payment Form">
    </FORM>

     Even though you have passed additional information 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.

    Back to the top

How to link a web site directly to the QuickCommerce Secure transaction gateway

    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)
    Back to the top

Example - Additional code 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 shows the changes and/or additions to the code above:

    <FORM method="POST" action="https://www.quickcommerce.net/scripts/qc25/WLDoTrans.asp">
       <INPUT type="HIDDEN" name="TYPE" value="NA">

    Select a Card Type:
       <SELECT name="METHOD">
         <OPTION value="Visa">Visa
         <OPTION value="MasterCard">MasterCard
         <OPTION value="AmericanExpress">American Express
      </SELECT>

    Enter Card Number:
        <INPUT type="TEXT" name="CARDNUM" size="16" maxlength="16">

    Expiration Date:
        <INPUT type="TEXT" name="EXPDATE" size="4" maxlength="4">

If the transaction is authorized, the customer will arrive on the QuickCommerce transaction receipt page.

Back to the top

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.

    Back to the top

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:

      Silent HTTP Form Post 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.

    Back to the top

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
      e-mail
      USER1
      USER2
      USER3
      USER4
      USER5
      USER6
      USER7
      USER8
      USER9
      USER10

    Back to the top


This work is © Copyright 1999 by E-Commerce Exchange.
All trade marks and brand names are acknowledged as belonging to their respective owners.