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

BluePay

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

 

What you need to start

You receive from BluePay a Merchant ID.

 

Gateway Configuration Data

The BluePay product homepage is under: http://bluepay.onlinedatacorp.com/

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

https://bluepay.onlinedatacorp.com/prod/bluepaylite.asp

For test inquiries, the URL is different:

https://bluepay.onlinedatacorp.com/test/bluepaylitetest.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.

The AVS implemented by this gateway is purely informative, there is no method to prevent the transaction to be recorded, and later processed.

Deletes and voids are not a function of BluePay Gateway’s Real-time Transaction System. Returns and Refunds are allowed, and must match an original sales capture within the BluePay Virtual Terminal.

Please refer to your merchant interface at BluePay for more information on turning off the “VT” only mode, and the block unknown “browsers” and “website referrals” within the security settings.

Also check here the Help section provided by BluePay

 

Payment Methods

The Supported payment method is CreditCard only.

Valid values for -ACTION

  • TEST
  • AUTH_CAPTURE

To VOID or CREDIT you have to use the manual online terminal.

 

 

Code to use for The CITY Shop

 

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

Certifying your Cart

BluePay requires that you start the cart in TEST MODE, so they can certify your installation. For that, add the key -GATEWAY_TEST in your $MerchantData:

$MerchantData = {
  -GATEWAY_NAME => 'bluepay',
  -GATEWAY_TEST => 1,
  -MERCHANT_ID  => '123456789012345', 
  -GATEWAY_CONNECT_METHOD => 'SubmitLWPUserAgent', # or SubmitNetSSLeay 
};

Reply to: certification@bluepay.onlinedatacorp.com with the subject line: “please certify” once you have completed a successful test transaction through the BluePay Test server using the test cards provided in the BluePay Operations Guide. Please provide the order id with this information.

 

If your merchant account is set up to automatically require the password for all transactions, then you will have to enter the password in the -MERCHANT_PASSWORD key.

This merchant gateway REQUIRES 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)],

 

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

 

Used fields

The required fields:

-ORDER_AMOUNT
-ORDER_NUMBER
-CARD_NUMBER
-CARD_EXPIRES
-CARD_CIC_NUMBER
-USER_FULL_NAME (or -USER_FIRST_NAME/-USER_LAST_NAME)
-USER_ADDRESS
-USER_CITY
-USER_STATE
-USER_ZIP

The Optional fields:

-ORDER_DESCRIPTION
-USER_ADDRESS2
-USER_COUNTRY
-USER_PHONE
-USER_EMAIL

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

 

Certified Shopping Cart Help Section

We have taken the time to help with certain issues that most merchants will have regarding transactions between BluePay and your Shopping Cart. Please use the information provided below to assist you in the creation of your help documentation. Not only will this information be a valuable resource to your customers, but will also help save time and expense with future customer service issues.

TEST vs. PROD

Many shopping cart providers create an option to switch from “Test” mode to “Live” mode. If this is not created, then information regarding “Live” transactions must be explained in the help files.

All transactions run through the BluePay “PROD” environment will be ran as live transactions. Test credit cards will be declined through this server environment.

BluePay TEST Environment.

Please use only the TEST credit cards that are listed in the BluePay Guide, the BluePay “TEST” environment will decline live credit cards.

VT Only & Block Settings

Within the Help files, merchants will need an explanation on turning off the “VT” only mode. There are two other settings that may or may not effect the sending of transactions from your shopping cart to BluePay. These settings are the block unknown “browsers” and “website referrals” within the BluePay Security Settings menu. These settings are only listed in the PROD environment. Please make sure that your merchants have access to this information within your help section so that the proper settings are disabled. These settings may or may not block transactions from your shopping cart system.

Please disable the BluePay Security Settings from the BluePay Login. Please check with your technical support representative from your storebuilder to be sure which settings will apply.

BluePay Selection in your Shopping Cart

Many Shopping Cart providers create a help section with instructions on setting up BluePay Gateway through your Shopping cart admin.

SALES vs. AUTH and the function of VOID and REFUNDS

Once a SALE or CAPTURE (post auth) is completed, it cannot be deleted from the real-time host capture system.Your help section will need an explanation that explains that deletes and voids are not a function of BluePay Gateway’s Real-time Transaction System (for CAPTURES and SALES). Returns and Refunds are allowed, and must match an original sales capture within the BluePay Virtual Terminal.

Transactions performed as a “SALE” cannot be deleted or voided from the BluePay Real-time Host system.

Transactions performed as an “AUTH” can be deleted at the “Capture” screen.

We will need a link to the URL for your shopping cart, and technical support contact information for which we can post on our web site once we have certified your cart.