Please wait ...


Loading...

Configuration in Zen Cart

1. Information on the payment in Zen Cart

Find information about the payment in Customers -> Orders in your Zen Cart administration. See image 8 below for an example.

In the order view you’ll find the following information: transaction ID, amount, currency code, payment date, Fraud Fighter notifications, card type, and transaction fee.

When clicking on an order, you’ll see a link to your ePay administration for processing the payment (see image 9). The order and transaction numbers from Zan Cart match the numbers in ePay.

2. Settings

Go to the menu Modules -> Payment, click on the ePay module and choose ’Edit’ on the right.

Enabled

To activate ePay in Zen Cart, set this at Enabled.

Order status (before the payment is made)

Enter the status any order should have before it is paid. This is used to distinguish between paid and non-paid orders. Please see the next setting as well: New order status (when the payment is made).

New order status (when the payment is made)

Enter the status any order should have after it is paid. This is used to distinguish between paid and non-paid orders. Please see the previous setting as well: Order status (before the payment is made).

Sort order of display

Choose the countries from which customers can pay using this payment method.

Payment zone

Choose the countries from which customers can pay using this payment method.

Merchant number

Your merchant number is the agreement number with you acquirer. You can find it in your ePay administration in the menu Settings -> Payment system.

Show guide

This determines if the instructions ”What are check digits?” should be displayed when using integrated layout.

Show cardholder name field

Activate this to allow the customers to enter their names with the card information. The name appears in the ePay administration on the payment.

Show comment field

Activate this to allow the customers to ennter a comment with the payment when using integrated layout. The comment appears in the ePay administration on the payment.

Show ePay logo

Choose if ePay’s logo should be displayed at checkout.

Instant capture

If you activate instant capture, the payment is captured immediately. You can only use this setting if your customers get their goods right away, e.g. downloads or services.

Split payment

Activate this if payments should be processed as split payments. Using split payments you can divide payments into two or more transactions and capture smaller parts of the amount one at a time. You can capture a part of the amount as each item is shipped. Read more about split payments here.

Process payment from the order administration of Zen Cart

If you want to process your payments from Zen Cart, activate this setting. This enables you to capture, credit or delete payments from the Zen Cart administration.

Group

You can divide your payments into different groups, and limit your ePay users’ access to specific groups. A group is a name/string. Leave the field empty if you don’t want to use groups.

MD5 type

We recommend that you use MD5 to secure the data sent between your system and ePay. 

MD5 key

If MD5 is activated, please enter your secret key here – the key you entered in your ePay administration. The keys have to be perfectly identical as they are case sensitive. 

Auth Mail

To receive an email at every completed payment, enter an email address here. If you have multiple recipients, you can separate the addresses with a semicolon (;). Leave the field empty if you don’t want to use this service.

Integrated layout

If you want to integrate the payment form on your website instead of using our payment window, put this setting at (1).

Window state

Choose whether the payment window should open in the same browser window as the website, or in a pop-up window.

Add fee

By activating this, the transaction fee is placed on the customer. An extra step is added to the payment process, and the customer is asked to accept the transaction fee.

Add payment fee to the 'order and invoice'

If you activate this, the transaction fee will appear on the customer’s order and invoice. Note that ‘transaction fee’ in Modules -> Order Total in the Zen Cart administration must be activated.

Enable validation

Activate this to run a JavaScript validation of the card information when the customer enters the information. This means that the customer is notified if the entered number is incorrect. You can only use validation in integrated layout. 

Which logos to show

Choose which logos to show when your customers pay. The list contains payment card logos as well as ”credibillity” logos. By default all logos are displayed, and you can remove logos you don’t want to show to the customer.  

Payment options integrated payment form

Choose the payment methods available to your customers. You can choose between eDankort, Nordea e-betaling, and Danske Netbetaling. The customer switches between them in a dropdown menu. You can only use this setting in integrated layout.   

Own receipt

Enter a URL here to send the customer to your own confirmation page at completed payment. The page must be set up in Zen Cart. 


The abovementioned functions are all integrated into the module for Zen Cart. Please note that you can manually implement all the functions we offer by adding the relevant parameters in your code. Click here for a list of all available parameters.

3. Change language

You can add a new language or edit an existing language by using the method below.

Edit an existing language:

Go to the folder \includes\languages\english\modules\payment

Open the file epaywindow.php, and make the desired changes.

Please note that you can only edit the column on the right in image 10 (the highlighted area). If you change anything in the column on the left, the translation will fail.

Add a new language:

Copy the file epaywindow.php to another folder, for instance \includes\languages\german\modules\payment

Open the file \includes\languages\german\modules\payment\epaywindow.php

The file contains the labels that define the language in the payment module (please see image 10). Edit the file, but please notice that you can only edit the column on the right. 

If you want the Zen Cart administration in Danish, please install this package: http://www.zen-cart.com/downloads.php?do=file&id=891

4. Process payments from Zen Cart

You can process your payments from the Zen Cart administration.

Activate this by enabling the setting: ”Process payments from within the order administration of Zen Cart”.

You must activate API in the ePay administration. Go to the menu API/Web service -> Access in the ePay administration, and enter the IP address on which your Zen Cart runs.

When you find the order in Zen Cart, the following information is available:

  • Transaction status
  • Order number
  • Acquirer
  • Currency code
  • Split payment status
  • 3D Secure status
  • Description (if any)
  • Card holder’s name (if any)
  • Authorised amount and time stamp
  • Captured amount and time stamp
  • Credited amount and time stamp
  • Transaction fee (if any)

To capture a transaction, find the order, enter the amount you want to capture, and press ‘Capture’. 

To cancel an order and delete the payment, find the order, and press ‘Delete’. The transaction is deleted in ePay’s administration.

To credit a payment, find the order, enter the amount you want to refund, and press the ‘Credit’ button.

5. Make changes to Zen Cart files

When the ePay module is installed certain Zen Cart files are overwritten. If you’ve made any changes to these files, your files should be merged with the files from ePay’s module.

The installation overwrites the following files:
includes/modules/checkout_process.php

All changes from ePay are indicated by:

// ———— ePay added start ———

and

// ———— ePay added end ———