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

IPayment

IPayment is a Germany based company. IPayment supports transactions in various currencies.

 

What you need to start

You receive from IPayment the following information:

  • merchant ID
  • User ID
  • Transaction Password

 

Gateway Configuration Data

The IPayment product homepage is under: http://www.ipayment.de/

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 methods are CreditCard and ACH.

Valid values for -ACTION

For CreditCard:

  • TEST
  • AUTH_CAPTURE
  • CAPTURE_ONLY
  • PRIOR_AUTH_CAPTURE
  • CREDIT

For ACH:

  • AUTH_CAPTURE

 

 

Code to use for The CITY Shop

 

$MerchantData = {
  -GATEWAY_NAME      => 'IPayment',
-MERCHANT_ID => '8765432',
-MERCHANT_ID2 => '987',
-MERCHANT_PASSWORD => '98765432', -GATEWAY_CONNECT_METHOD => 'SubmitLWPUserAgent', # or SubmitNetSSLeay -GATEWAY_ALLOWED_CURRENCIES => [qw(USD EUR GBP)], # set here what your account supports };

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)],

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 value of the User ID provided to you by the gateway.

-MERCHANT_PASSWORD2
This is the value of the Transaction Password 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"

-GATEWAY_ALLOWED_CURRENCIES
Depending on what you agreed for your merchant account to support, you can define in here the currencies that are allowed as method of payment. You might want to restrict this list to a minimum, since your shop accepts payments in only one currency anyway. The default currency is EUR.

-GATEWAY_EMAIL_CUSTOMER
You can set this flag on "1" to enable the gateway to send the customer a confirmation email.

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

 

Used fields

Required Fields:

-ORDER_AMOUNT
-ORDER_CURRENCY
-CARD_NUMBER
-CARD_EXPIRES
-USER_FULL_NAME (or -USER_FIRST_NAME/-USER_LAST_NAME)
-USER_ADDRESS
-USER_CITY
-USER_ZIP
-USER_EMAIL
-TRANSACTION_ID - required for the payment method PRIOR_AUTH_CAPTURE and CREDIT

Optional Fields:

-USER_PHONE
-USER_FAX
-USER_COUNTRY
-ORDER_NUMBER
-ORDER_DESCRIPTION

 

Depending on the payment mode, here are the specific required fields:

For the CreditCard method:

Required Fields:

-CARD_NUMBER
-CARD_EXPIRES

Optional Fields:

-CARD_CVV2_NUMBER

 

For the ACH method:

Required Fields:

-BANK_NAME
-BANK_ACCT_NUMBER
-BANK_ABA_CODE

Optional Fields:

-BANK_COUNTRY

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