

                    Business::OnlinePayment::TCLink v1.02
                             Freeside Integration
                       Copyright (C) TrustCommerce 2002
                         http://www.trustcommerce.com
                         developer@trustcommerce.com

                                 Nov 4, 2002

I. DESCRIPTION

  Business::OnlinePayment::TCLink Module is a TrustCommerce payment
module for use with any e-commerce system that supports the Perl
Business::OnlinePayment API. This document describes using the module
with the the Freeside open-source billing and account administration
package, available here:

  http://www.sisd.com/freeside/

II. INSTALLATION

  First, install Freeside and configure it, as per the Freeside
documentation. Then follow the instructions in README for
Business::OnlinePayment::TCLink to install it as root.

III. CONFIGURATION

  Login to the Freeside web interface. Click on "Sysadmin" at the top,
and then click on "View/Edit invoice events". Select the "Batch card"
invoice event, which causes customer credit card transactions to be run
as a batch at the end of the day. Click "Disabled" and then "Apply
changes", because we want to do real-time credit card transactions.

  Click "Add invoice event" and add an event called
"Business::OnlinePayment". Under "Action", select "Run card with a
Business::OnlinePayment realtime gateway", and then click "Add invoice
event." Now transactions should be run through the
Business::OnlinePayment gateway that you configure.

To select TCLink as the gateway, go to the main menu, click on
"Sysadmin", and then on "Configuration". Click "Edit Configuration".
Scroll down to the "Billing configuration options". Take a look at the
business-onlinepayment setting. The first line of the text area should
be "TCLink". The second line should be your TrustCommerce customer ID,
the third your TrustCommerce password, and the fourth line should be the
type of action to run, such as "Authorization Only" (which is a
TrustCommerce preauth) or "Normal authorization" (which is a
TrustCommerce sale). Here is an example:

  TCLink
  99999
  password
  Authorization Only

  When you're done, click "Apply changes". Now you should be fully
configured for using TCLink.

  Note that more detailed Freeside billing information is available at:

  http://www.sisd.com/freeside/devdocs/billing.html

IV. USAGE

  Using the TCLink payment module via Freeside is as easy as performing
a real-time credit card transaction through the Freeside web interface.
Try out a test transaction, and then login to the TrustCommerce Vault to
ensure that the transaction went through correctly.

  If at any time you would like to change the settings for this module,
proceed to the billing configuration options on the configuration page as
described above, and then alter any of the settings that you desire.
