| 1 |
|
| 2 |
|
| 3 |
Business::OnlinePayment::TCLink v1.03 |
| 4 |
Freeside Integration |
| 5 |
Copyright (C) TrustCommerce 2002 |
| 6 |
http://www.trustcommerce.com |
| 7 |
[email protected] |
| 8 |
|
| 9 |
January 10, 2003 |
| 10 |
|
| 11 |
I. DESCRIPTION |
| 12 |
|
| 13 |
Business::OnlinePayment::TCLink Module is a TrustCommerce payment |
| 14 |
module for use with any e-commerce system that supports the Perl |
| 15 |
Business::OnlinePayment API. This document describes using the module |
| 16 |
with the the Freeside open-source billing and account administration |
| 17 |
package, available here: |
| 18 |
|
| 19 |
http://www.sisd.com/freeside/ |
| 20 |
|
| 21 |
II. INSTALLATION |
| 22 |
|
| 23 |
First, install Freeside and configure it, as per the Freeside |
| 24 |
documentation. Then follow the instructions in README for |
| 25 |
Business::OnlinePayment::TCLink to install it as root. |
| 26 |
|
| 27 |
III. CONFIGURATION |
| 28 |
|
| 29 |
Login to the Freeside web interface. Click on "Sysadmin" at the top, |
| 30 |
and then click on "View/Edit invoice events". Select the "Batch card" |
| 31 |
invoice event, which causes customer credit card transactions to be run |
| 32 |
as a batch at the end of the day. Click "Disabled" and then "Apply |
| 33 |
changes", because we want to do real-time credit card transactions. |
| 34 |
|
| 35 |
Click "Add invoice event" and add an event called |
| 36 |
"Business::OnlinePayment". Under "Action", select "Run card with a |
| 37 |
Business::OnlinePayment realtime gateway", and then click "Add invoice |
| 38 |
event." Now transactions should be run through the |
| 39 |
Business::OnlinePayment gateway that you configure. |
| 40 |
|
| 41 |
To select TCLink as the gateway, go to the main menu, click on |
| 42 |
"Sysadmin", and then on "Configuration". Click "Edit Configuration". |
| 43 |
Scroll down to the "Billing configuration options". Take a look at the |
| 44 |
business-onlinepayment setting. The first line of the text area should |
| 45 |
be "TCLink". The second line should be your TrustCommerce customer ID, |
| 46 |
the third your TrustCommerce password, and the fourth line should be the |
| 47 |
type of action to run, such as "Authorization Only" (which is a |
| 48 |
TrustCommerce preauth) or "Normal authorization" (which is a |
| 49 |
TrustCommerce sale). Here is an example: |
| 50 |
|
| 51 |
TCLink |
| 52 |
99999 |
| 53 |
password |
| 54 |
Authorization Only |
| 55 |
|
| 56 |
When you're done, click "Apply changes". Now you should be fully |
| 57 |
configured for using TCLink. |
| 58 |
|
| 59 |
Note that more detailed Freeside billing information is available at: |
| 60 |
|
| 61 |
http://www.sisd.com/freeside/devdocs/billing.html |
| 62 |
|
| 63 |
IV. USAGE |
| 64 |
|
| 65 |
Using the TCLink payment module via Freeside is as easy as performing |
| 66 |
a real-time credit card transaction through the Freeside web interface. |
| 67 |
Try out a test transaction, and then login to the TrustCommerce Vault to |
| 68 |
ensure that the transaction went through correctly. |
| 69 |
|
| 70 |
If at any time you would like to change the settings for this module, |
| 71 |
proceed to the billing configuration options on the configuration page as |
| 72 |
described above, and then alter any of the settings that you desire. |