Please wait ...


Installation in osCommerce

Payment module for osCommerce

ePay has developed a free payment module for osCommerce, making it easy to accept payment cards in your online shop.  

osCommerce is a free open source solution for e-commerce. We made it easy to install the module so you can focus on other tasks.

Download the module, and follow the 4 easy steps below – now you’re ready to go!

1. Create an ePay account

Before you can try the module you need an ePay test account. It’s free to sign up for a test account; it only takes a few minutes, and there are no strings attached. When you’ve created your account, you’ll receive a merchant number to be used for testing. 

Get a free account

Please state that you want a test account in the comment field found in step 2. You can disregard all prices.

Whenever you’re ready to accept real payments, we’ll upgrade your test account to a production account. This means you don’t have to create an account from scratch.

2. Install the ePay module in osCommerce

NB: Before beginning installation, please make a backup of your website.

Download the payment module and save the zip file to your hard drive.

Download the ePay module

Unzip the file.

Copy the contents from the folders admin and includes to your osCommerce installation, and overwrite the existing files.

Please note that the ePay module contains modified versions of standard osCommerce files. If you’ve made any changes to these files, you’ll have to merge these with the files from the ePay module. This requires some technical insights into osCommerce. Read more about the impacted files here.

Log in to your administration on http://yoururl/admin. Go to the menu Modules -> Payment (see below).

Press the button ‘Install Module’ at the top right corner (see image 2). Find ‘ePay Payment Solutions’ on the list, press it, and press ‘Install Module’ on the right (see image 3).

ePay’s module is installed, and your screen should look like image 4 below.

3. Activate the module in osCommerce

The payment module has been installed and needs to be activated.

Press the button ‘Edit’ to enter the configuration of ePay’s module.

Ensure that the setting Enabled is put at True to activate the module.

New order status is used to distinguish between paid and non-paid orders. You need to enter a value here, or your orders are not displayed correctly in osCommerce.

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

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

4. Test the payment module

Please ensure that the domain you’re testing from is registered in your ePay administration in Settings -> Payment system.  If the domain is not registered, ePay cannot open the payment window and present it to your customers.

To test the payment module simply complete a purchase and use our test payment card. Choose Credit Card ePay at checkout, and continue to the next page. When you’ve approved the order, you are sent to the payment window.

Find an example of ePays payment window in image 6. You can add your own logo and company information at the top of the window. Make these changes from the ePay administration in Settings -> Payment window.

The customers choose between all the payment methods activated on your ePay account. When the customers have paid and closed the payment window, they are sent to an order confirmation page which you can define in osCommerce (please see image 7).

The purchase is now completed; you’ve received the order, and ePay’s received the payment information.