Please wait ...


Installation in Zen Cart

Payment module for Zen Cart

ePay’s payment module for Zen Cart makes it simple to accept payment cards in your online store.

We made it easy to install and use our module, allowing you to focus on your business.

Download the module, and follow the 4 steps below to accept payments online.

1. Create an ePay account

You need an ePay test account to install the payment module for Zen Cart. A test account is free and can be set up in a few minutes. When you’ve created your account, you’ll get a test merchant number which is used to make test payments through the module.

Get a free account

In the comment field in step 2 simply state that you want a test account. You can disregard all listed prices.

When you’ve tried the payment module and feel ready to go live, you simply notify ePay and we’ll upgrade your test account to a production account. This saves you from the trouble of creating a new account.

2. Install the ePay module in Zen Cart

NB: Remember to make a backup of your website before beginning installation.

Download the module, and save the file to your harddrive.

Click here to download 

Unzip the file.

Copy/paste the contents from the folder catalog to you Zen Cart installation, and overwrite the existing files.

Please notice that the ePay module contains modified versions of standard Zen Cart files. If you’ve made any changes to these files, these files must be merged with the files from the module. This, however, requires some technical insights into Zen Cart. Find the concerned files here

Log in to your Zen Cart installation on http://yoururl/admin, and go to the menu Modules -> Payment (see image 1 below).

Choose ePay from the list, and press ‘Install’ on the right.

The payment module is now installed, and your screen should look like image 2 below.

3. Activate the module in Zen Cart

Before use, the module must be activated. 

Press the button ‘Edit’ by the ePay module in the menu Modules -> Payment.

Choose True by “Enabled” to activate the module.

Define a value for the fields “Order status” and “New order status”. These values are necessary for Zen Cart to differentiate between paid and non-paid orders, and for this reason their default values are Pending (order status) and Processing (new order status). 

Enter your merchant number in the field “Merchant number”. You received the number from ePay, and it’s either a test or production merchant number. 

Please remember to state which payment forms you accept in Payment options integrated payment form. Note that each payment form requires separate agreements.

Press the ‘Update’ button at the bottom of the page to save your settings.

4. Test the module

The domain from which you’re running your tests must be registered on your ePay administration in Settings -> Payment system. If you didn’t register it, ePay cannot open the payment window and present it to your customers.

Simply make a purchase in your store to test the module. Choose ”Pay with your credit card (ePay)” on the checkout page (see image 3), and continue to the next page. 

Confirm your order before the payment window opens. Below are two examples of the payment window: in a pop up version in image 4, and integrated on your website in image 5. The setting Window state determines which version is used.

You can place your own logo and company information at the top of the payment window. Go to Settings -> Payment window in the ePay administration to do so.

Your customers can choose between all the payment methods activated on your ePay account. When the payment is completed, a receipt is show in the payment window (see image 6), and when the payment window is closed, the customers are sent to a confirmation page which is defined in Zen Cart (see image 7). 

The payment process is now completed. You’ve received the order, and ePay’s received the payment card information.