Nightmedia - EPI PayBill Interface

The EPI - E-Payment Interface

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

Skipjack

Skipjack is a US based company. Skipjack supports transactions in USD only.

What you need to start

You receive from Skipjack a merchant ID

Gateway Configuration Data

The Skipjack product homepage is under: http://www.skipjack.com/

This package uses a SSL backlink method to submit the data to the url:

https://www.skipjackic.com/scripts/evolvcc.dll?Authorize

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

Code to use for The CITY Shop

$MerchantData = {
  -GATEWAY_NAME           => 'Skipjack',
  -MERCHANT_ID            => '12345',
  -GATEWAY_CONNECT_METHOD => 'SubmitLWPUserAgent', # or SubmitNetSSLeay
};

This merchant gateway SUPPORTS the form field CCCICNumber. To remind you, this is the 3 digit credit card security number on the back of the card. 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)],

Also, you will NEED to provide the -USER_PHONE as listed below. In the shop, this will be taken from the billing phone ("BPhone"). The best way to require that field is to put the BPhone in the list of required fields:

 -SHOP_ORDER_FORM_BILLING_FIELDS_REQUIRED => [qw(BFirstName                
  BLastName BAddress BCity BZip BState BCountry BEmail BPhone)],

There is also the option to use the field "CCPhone", which might be defined in the description of your usercreditcard table. Of course, in that case you will need to modify the ShopBillingLib.pm and change the field assignment to:

 -USER_PHONE => 'CCPhone',

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.

-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 "SKIPJACK.log"

Used fields

The required fields:

-USER_FULL_NAME (or -USER_FIRST_NAME/-USER_LAST_NAME)
-USER_EMAIL
-USER_ADDRESS
-USER_CITY
-USER_STATE
-USER_ZIP
-USER_PHONE
-CARD_NUMBER
-CARD_EXPIRES
-CARD_EXP_MONTH
-CARD_EXP_YEAR
-ORDER_NUMBER
-ORDER_AMOUNT

The Optional fields:

-CARD_CVV2_NUMBER
-ORDER_DESCRIPTION
-USER_ADDRESS2
-USER_COUNTRY
-USER_FAX
-SHIP_FULL_NAME
-SHIP_ADDRESS
-SHIP_ADDRESS2
-SHIP_CITY
-SHIP_ZIP
-SHIP_COUNTRY
-SHIP_FAX

-CARD_TRACK1
This is the Credit card track data which can be read with a physical card terminal.

-ORDER_PRODUCT_COUNT
This is the number of items in the cart. If you provide it, you have to provide the next fields too:

These fields need to be formatted as array references:
-ORDER_PRODUCT_QUANTITY - 4 digit item quantity
-ORDER_PRODUCT_PRICE
-ORDER_PRODUCT_DESCRIPTION - 30 characters string
-ORDER_PRODUCT_SKU - 30 characters string

The following characters are not allowes in the items above: "~`!@#$%^&*()_\-+=

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