gateway

Gateway Configuration

The first step is to fulfil the prerequisites of the payment module (listed in the individual module documentation below) and enable the module in the global configuration file with the Require directive:

require Vend::Payment::NetBilling

If we are using only one gateway in a catalog, setting up MV_PAYMENT variables is sufficient.

VariablePurposeNotes
MV_PAYMENT_MODEgateway mode name 
MV_PAYMENT_HOSTgateway host nameoptional (predefined in module)
MV_PAYMENT_IDmerchant identifier 
MV_PAYMENT_SECRETsecret part of credentialspassword or certificate
MV_PAYMENT_REFERERreferring URL 
MV_PAYMENT_CURRENCYcurrencythree-letter currency code according to ISO 4217
MV_PAYMENT_TESTtest mode 

An example configuration looks like:

Variable MV_PAYMENT_MODE signio
Variable MV_PAYMENT_PARTNER verisign
Variable MV_PAYMENT_ID nevairbe
Variable MV_PAYMENT_SECRET foobar

Multiple Gateways

With the Route directive it is possible to specify payment gateways for special purposes. The payment route should set all relevant payment parameters for the gateway, otherwise the settings from the MV_PAYMENT_* may leak into the route.

Route signio partner verisign
Route signio id nevairbe
Route signio secret foobar

Transaction Types

The following payment gateway transactions are known by Interchange:

TransactionDescription
avsAddress verification (AVS)
authPayment authorization (Charge)
returnCredit
reverseReverse former transaction
saleCharge and capture
settleCapture of an authorized charge
voidCancel or refund payment
abortAbort pending capture.

Payment Modules

Modules for the following payment gateways are included in the Interchange source code:

ModuleNameModeDescription
AuthorizeNetAuthorizeNetauthorizenet 
BoABank of Americaboa 
BusinessOnlinePaymentBusiness::OnlinePaymentonlinepaymentwrapper for Business::OnlinePayment
CybercashCybercashcybercash 
ECHOElectronic Clearing House, Inc.echo 
EFSNetConcord EFSNetecho 
EzicEziCezic 
GetitcardGetitcardgetitcardPrepaid cards from Getitcard.
ICSCybersource ICSICS 
iTransactiTransactitransact 
LinkpointLinkPointlinkpoint 
MCVEMainstreet Credit Verification Enginemcve 
NetBillingNetBillingnetbilling 
PRIPayment Resources InternationalPRI 
PSiGatePSiGatepsigate 
SageSage Paymentsage 
SignioPayflow Prosignio 
SkipjackSkipjackskipjack 
TCLinkTrustCommercetrustcommerce 
TestPaymentPayment Testtestpaymentfor test purposes

AuthorizeNet

The AuthorizeNet module implements the ADC Direct Response method for AuthorizeNet version 3.

Prerequisites

Either Net::SSLeay or LWP::UserAgent and Crypt::SSLeay from CPAN.

Parameters

Required parameters are id and secret.

id

The AuthorizeNet account ID, received from AuthorizeNet after sign up.

secret

The AuthorizeNet account password, received from AuthorizeNet after sign up.

ECHO

Prerequisites

OpenECHO module from http://www.openecho.com/.

Getitcard

The Getitcard payment module is used for purchases with prepaid cards issued by GetitcardŽ (http://www.getitcard.com/).

Prerequisites

Either Net::SSLeay or LWP::UserAgent and Crypt::SSLeay from CPAN.

Parameters

Required parameter is id.

LinkPoint

Parameters

Required parameters are id and keyfile.

host

The domain name of the LinkPoint Secure Payment Gateway (LSPG). Default is secure.linkpt.net for production and staging.linkpt.net for testing.

id

Store number assigned to your merchant account.

keyfile

File name of the merchant security certificate. This file should contain the RSA private key and the certificate, otherwise you get an error like "Unable to open/parse client certificate file."

transaction

The type of transaction to be run. Valid values are:

InterchangeLinkpoint
authpreauth
salesale

Default is sale.

Netbilling

The Netbilling module implements the Netbilling Direct Mode 2.1.

Prerequisites

Parameters

host

The domain name of the NetBilling secure server. Defaults to secure.netbilling.com.

id

This is your account and sitetag separated by a colon (ACCOUNT:SITETAG). ACCOUNT is the number of your Netbilling merchant or agent account, as a 12-character string. Required for ALL transactions. SITETAG is the site tag of your website configured in the Netbilling system. Required for membership transactions, optional for others.

Sage

Parameters

Required parameters are id and secret.

Signio

Parameters

Required parameters are partner, id, and secret.

TCLink

Prerequisites

Net::TCLink module from http://www.trustcommerce.com/tclink.html or CPAN.

TestPayment

This module can be used for test purposes.

Card Numbers

If the card number is 4111111111111111 then the transaction will be approved.

If the card number is 4111111111111129 then the transaction will be declined.

Any other card number will raise an error and the transaction will be declined.

DocBook! Interchange!