Please wait ...


Loading...

Configuration in Joomla

  • Notification service
  • Get updates in your inbox.
    Sign up here.



1. Information on the payment in Joomla

When the payment is completed, you can see it in Joomla in the menu Components -> ePay Payment Solutions

Find more information about the transaction by clicking on the transaction ID.

2. Settings

Find the settings for the module by choosing Components -> ePay Payment Solutions in the menu.

Merchant number

Enter the merchant number you received from ePay. Find it via the menu Settings -> Payment system in your ePay administration.

Window ID

Specify which version of the payment window to use. You create different versions from the ePay administration in the menu Settings -> Payment window. Use this to show different texts and logos or apply different settings for transaction fees.

Use API

If you activate this, you can process your payments from Joomla. This means you don’t have to log in to your ePay account to capture, delete, or credit payments.

Group

If you need to, 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 (default).

Show email

Put at Show to display an email field on the payment page.

Show name

Put at Show to display a name field on the payment page. 

Show address

Put at Show to display an address field on the payment page.

Show country

Put at Show to display a country field on the payment page.

Show phone

Put at Show to display a telephone field on the payment page.

Show comment

Put at Show to display a comment field on the payment page.

Menu containing terms

Enter the menu in Joomla which contains your terms and conditions.

Require accept terms

Put at Yes if the customer must accept your terms and conditions before the payment can be completed.

Available currencies

Specify which currencies the customer can choose from.

Available payment methods

Specify which payment card logos to display at payment.

Company name

Enter your company name.

Company email

Enter the email address from which the payment confirmation email is sent. If you don’t want to send a confirmation email, leave the field blank.

E-mail payment confirmation

Enter the email addresses which are to receive a confirmation email. This requires that "Company Email" is stated.

Show Cardholder name

Put at Show if the customer must enter his/her name in the payment window.

Customer pays the payment fee

Activate this to place the transaction fee on the customer. An extra step is added to the payment process, and the customer is informed about the size of the fee and asked to confirm it.

Instant capture

Activate this to capture your payments immediately. You can only use instant capture if your customers receive their goods immediately as well (e.g. downloads or services). 

MD5 key

If you use MD5, please enter your key here (the same key you entered in your ePay administration). The keys must be identical in the two systems. 

Auth E-mail

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

Split payment

Activate this to process all payments as split payments. This means you can divide a payment into two or more transactions and capture parts of the amount one at a time, which is useful if an order is split into several deliveries. Read more about split payments here.

3. Configuration of language

You can change the language in the invoice module or add a new language.

Change existing language:

Go to the folder \languages\da-DK\

Open the file da-DK.com_epay.ini, and make your changes.

You can only edit the column on the right side; If you edit the left column, the translation will fail.

Add new language:

Copy the file da-DK.com_epay.ini to for instance \languages\de-DE\

Open the file \languages\de-DE\da-DK.com_epay.ini. This file contains the labels which define the language of the invoice module.

Follow the same procedure to change the language of the administration, but use the folder administrator instead.

4. Process payments from Joomla

You can process payments from the order view in Joomla. This means you don’t have to log in to the ePay administration to capture, credit, or delete payments.

The setting “Use API” must be set at Yes. When this is activated, you have to register the IP address of your Joomla system in the ePay administration in the menu API/Webservices -> Access

When viewing the order in Joomla, you’ll find the following information about the transaction:

  • Transaction status
  • Acquirer
  • Currency code
  • Split payment status (if used)
  • Description (if any)
  • Cardholder’s name (if used)
  • Authorised amount and timestamp
  • Captured amount and timestamp
  • Credited amount and timestamp

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

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

To delete a payment, find the order, and press ‘Delete’.

5. Change mail-template

If you want to change the layout of the order confirmation email, use the file components\com_epay\mail-template.php

The following strings will be replaced:

[tid] is replaced with the transaction ID
[orderid] is replaced with the order ID
[cur] is replaced with the currency
[transfee] is replaced with the transaction fee
[company] is replaced with the company name
[date] is replaced with the date
[time] is replaced with the time
[cemail] is replaced with the customer’s email address
[cname] is replaced with the customer’s name
[caddress] is replaced with the customer’s address
[ccountry] is replaced with the customer’s country
[cphone] is replaced with the customer’s phone number
[ccomment] is replaced with the customer’s comment

6. Direct link

You can create a direct link to the payment page with prefilled values for some of the fields.

The URL must be defined like this:

http://yourjoomla.dk/index.php?option=com_epay&Itemid=[menuitemid]&set_amount=[amount]&set_invoice=[invoice]&set_email=[email]&set_currency=[currency]

The values are replaced as such:

[menuitemid] is replaced with the menu ID which is associated with your payment page in Joomla
[amount] is replaced with the amount in minor units, e.g. 19999 for DKK 199.99.
[invoice] is replaced with the invoice number
[email] is replaced with the customer’s email address
[currency] is replaced with the currency of the payment

An example of a correct URL: 

http://yourjoomla.dk/index.php?option=com_epay&Itemid=3&set_amount=5158&set_invoice=81&set_email=
customer@email.dk&set_currency=208


This link leads to the payment page.
Fork me on GitHub