iTransact
eCommerce Gateway
Setup
LinkPoint
ClickBank
PayPal
iTransact
|
iTransact Gateway Setup
1. Enable iTransact via e-Commerce Gateway section of System Setup panel.
2. Enter you iTransact Gateway ID into corresponding filed of System Setup panel
3. Create a product of Receipt type to be used as default product when using internal payment form and
enter its id into Default receipt product ID field (System Setup panel).
4. Enter minimum transaction amount into Minimum transaction amount field (System Setup panel). Accounts
Online will automatically add Pay Now button into Main screen of MyAccount panel if current balance is
greater of equal than minimum transaction amount value.
To use iTransact in test mode, you will also need to login to your iTransact Control Panel and enable test mode.
Please note, that "Test Mode" field settings (as per Accounts Online System Setup Panel) do not affect behavior of
iTransact processing by eCommerce Gateway.
To use iTransact in real transaction processing mode, you will also need to login to your iTransact Control Panel
and complete Card Setup procedure. Please refer to iTransact instructions for more information.
Your order page should contain the following code
<form method="post" action="https://secure.paymentclearing.com/cgi-bin/mas/buynow.cgi">
<input type="hidden" name="vendor_id" value="your-gateway-id">
<input type="hidden" name="home_page" value="url-of-your-site">
<input type="hidden" name="ret_addr" value="complete-url-to-your/accview.pl">
<input type="hidden" name="1_desc" value="description-of-order">
<input type="hidden" name="1_cost" value="order-price">
<input type="hidden" name="1_qty" value="1">
<input type="hidden" name="showaddr" value="1">
<input type="hidden" name="mername" value="your-company-name">
<input type="hidden" name="acceptcards" value="1">
<input type="hidden" name="acceptchecks" value="0">
<input type="hidden" name="accepteft" value="0">
<input type="hidden" name="altaddr" value="0">
<input type="hidden" name="nonum" value="1">
<input type="hidden" name="ret_mode" value="post">
<input type="hidden" name="passback" value="trid">
<input type="hidden" name="trid" value="random-number">
<input type="hidden" name="passback" value="cmd">
<input type="hidden" name="cmd" value="login">
<input type="hidden" name="passback" value="prodid">
<input type="hidden" name="prodid" value="existing-product-id">
<input type="hidden" name="lookup" value="authcode">
<input type="hidden" name="lookup" value="total">
<input type="hidden" name="lookup" value="xid">
<input type="submit" value="Pay now">
</form>
Note: In order to generate random value for trid input you can use ssirandom.pl script included
into standard eCommerce Gateway package. Here is a sample of trid input source using ssirandom.pl:
<input type="hidden" name="trid" value="<!--#include virtual="path-to-your-cgi-bin/ssirandom.pl"-->">
If you use custom script to generate payment form, you can use Accounts Online API to obtain
account login and password info. If you have this information, you can add the following fields to
the form above in order to avoid login form upon return from iTransact server:
<input type="hidden" name="passback" value="accid">
<input type="hidden" name="accid" value="account-id">
<input type="hidden" name="passback" value="passwd">
<input type="hidden" name="passwd" value="account-password">
Notes on using PGP signature
In order to secure e-commerce transactions iTransact digitally signs all data passed back to eCommerce Gateway. In order
to verify digital signature you will need pgp software installed on your system. Please refer to PGP documentation
for information regarding installation and configuring pgp on your system.
In order to enable pgp signature verification check on "Use PGP with iTransact" check box (Accounts Online
System Setup Panel). eCommerce Gateway will try to call command line pgp tool to verify iTransact signature.
When configuring pgp for use with eCommerce Gateway please consider the following:
1. eCommerce Gateway assumes that path to pgp command line tool is included to environment PATH variable
2. Under UNIX eCommerce Gateway exports PGPPATH variable initialized to value of "path to PGP data directory" as per
Accounts Online System Setup before calling pgp. Under Window NT/2000 eCommerce Gateway assumes that PGPPATH variable
properly set by your system administrator.
3. eCommerce Gateway assumes that you imported and signed public pgp key provided by iTransact. No checks if key exists
and is valid are being made.
4. eCommerce Gateway assumes that both directory and files within the directory specified with PGPPATH environment
variable are in read/write mode.
If you have problems installing and configuring pgp, you can order setup services from Eastwright Corp. Please use
support forms to submit your request.
|
