The EPI - E-Payment Interface

 

Overview | Concept | Licensing | Download | Installation | Sample Code | FAQ

Products | Scripts | Services | Tutorials | Books | Links | Contact | Bulletin Board

Please follow the links below to read the documentation specific to your gateway:

AuthorizeNet | BluePay | CyberCash | Echo Inc. | ESec | FirePay | GO Software(PCCharge)

iBill | Innovative Gateway | IntelliPay | Iongate | IPayment | LinkPoint | NovaInfo | PayBill

PayPal | PaySystems | Plug-n-Pay | Qenta | Skipjack | TeleCash | VeriSign | WorldPay

Nova Information Systems

Nova Information Systems is an US based company. As of this writing, Nova supports only transactions in US dollars.

 

What you need to start

You receive from Nova Info the following data:

  • Merchant ID
  • Merchant Password

 

Gateway Configuration Data

The Nova product homepage is under: http://www.novainfo.com/

The variables are matching the viaKLIX version of the gateway, as per included documentation from the "viaKlix Developer Guide Beta 2"

This package uses a SSL backlink method to submit the data to the following url:
https://www.viaklix.com/process.asp

You will need the following software installed:

Net::SSLeay v1.15
OpenSSL v0.9.6c

Please check the Net::SSLeay web page for the correct version required:
http://symlabs.com/Net_SSLeay/

For the people that don't have Net::SSLeay installed (NT folks),
there is an alternative submission method using:

LWP::UserAgent
Crypt::SSLeay

Please see the main installation instructions for more information on configuring the SSL modules.

 

Payment Methods

The Supported payment method is CreditCard only.

Valid values for -ACTION

  • TEST
  • AUTH_CAPTURE
  • CREDIT

 

Code to use for The CITY Shop

 

$MerchantData = {
  -GATEWAY_NAME           => 'novainfo',
  -MERCHANT_ID            => 'abc123',
  -MERCHANT_PASSWORD      => 'abc123',
  -GATEWAY_CONNECT_METHOD => 'SubmitLWPUserAgent', # or SubmitNetSSLeay
};

This merchant gateway USES the form field CCCICNumber. To remind you, this is the 3 digit credit card security number on the back of the card. If you want, you can flag this as required in the ShopSetup.pm, as follows:

-SHOP_PAYMENT_DATA_CC_FIELDS_REQUIRED => [qw(CCName CCAddress CCCity          
  CCZip CCState CCCountry CCNumber CCExpires CCCICNumber)],

If you configure this for The CITY Shop, that is all you need to know, and you can return to the installation instructions.

 

Description of the used parameters:

-MERCHANT_ID
This is the merchant ID provided to you by the gateway.

-MERCHANT_PASSWORD
This is the merchant Password provided to you by the gateway.

-MERCHANT_EMAIL
This is the Merchant Email that you want to use to receive the order confirmations

-GATEWAY_EMAIL_CUSTOMER
If enabled, this flag triggers an order confirmation email from the payment gateway to the customer.

-GATEWAY_EMAIL_MERCHANT
If enabled, this flag triggers an order confirmation email from the payment gateway to the merchant.

-GATEWAY_CONNECT_METHOD
This is the same as the key used by the "normal" payment gateways, and points to the method used to connect to the gateway site, in order to finalize the transaction. The allowed values are "SubmitLWPUserAgent" and "SubmitNetSSLeay"

-LOG_ACTIVITY
This is a flag that you can set on "1" if you want to log the gateway activity

-LOG_FILE_PATH
This is the path where the log file will be created. Note that this is a path only, and the script will create there a file named "NOVAINFO.log"

 

Used fields

The required fields:

-ORDER_AMOUNT
-ORDER_DESCRIPTION
-CARD_NUMBER
-CARD_EXPIRES
-USER_FULL_NAME (or -USER_FIRST_NAME/-USER_LAST_NAME)
-USER_ADDRESS (required only if AVS is enabled)
-USER_ZIP (required only if AVS is enabled)

The Optional fields:

-CARD_CIC_NUMBER
-USER_CITY
-USER_STATE
-USER_COUNTRY
-USER_PHONE
-USER_EMAIL


 

Look in the main install documentation for examples of passing the data to perform a transaction.