[Skip to main content](#vessel-content)

[View on the marketplace →](/marketplace/display/product/145-payment-epay) ☰ Documentation

#  ePay by Bambora payment plugin

Details    Written by: Administrator    Category: [Payment plugins](/support/documentation/hikashop/payment-plugins)     Published: 10 November 2026     Hits: 8

## Installation

- 1) You need an ePay merchant account (the Danish payment gateway run by Bambora). In your ePay administration, the Merchant Number and the Secret MD5 key are under Settings > Payment system, and the payment windows under Settings > Payment window.
- 2) For capturing or refunding from the HikaShop backend and for recurring payments, also set a web service password and add the IP address of your server under API/Webservices > Access in your ePay administration. The PHP SOAP extension has to be available on your server.
- 3) Install this plugin on your Joomla website with the extension installer.
- 4) In HikaShop, go to System > Payment methods, click "New" and choose Epay.
- 5) Type your Merchant Number, your Secret MD5 key and your Window Id, set "Published" to Yes, and save.

## Configuration

![The ePay settings in the HikaShop payment method](/images/doc/plugins/bambora/plg_hikashoppayment_bambora_settings.png)

- **Merchant Number**: the Merchant Number of your ePay account (menu Settings > Payment system).
- **Secret MD5 Key**: the key of your ePay account (Settings > Payment system). It is used to check every message coming back from ePay: with it empty or wrong, the payments are never confirmed in your shop and you receive an email telling a notification was refused.
- **Window Id to use**: the number of the ePay payment window the customer sees (Settings > Payment window).
- **Webservice password**: the password of the ePay web service (API/Webservices > Access). It is needed for the capture, the refund and the recurring payments done from the shop; leave it empty if your ePay account has no such password.
- **IP address**: shown for information only. It reminds you to add your server's IP address under API/Webservices > Access in your ePay administration to complete recurring payments.
- **Handle payments for non recurring products**: Yes (the default) lets this method be used for ordinary one-time orders. No keeps it for orders with a recurring payment (HikaSubscription) only.
- **Send details of the order**: Yes or No. The setting is kept, but the current version does not use it for the payment.
- **Instant Capture**: Always (the default) takes the money as soon as the customer pays. No only reserves the amount: you capture it by moving the order from the Pending status to the Verified status in the backend, and moving a confirmed order to a cancelled status credits the money back through ePay. Recurring takes the money at once for a recurring payment and reserves it for an ordinary order.
- **Skip epay receipt page**: Yes brings the customer straight back to your shop after paying, instead of showing ePay's receipt page first.
- **Text on Statement**: up to 20 characters shown on the statement of your customer's bank, only for acquirers that support it (Shift4 and Clearhaus).
- **Debug**: Yes writes the exchanges with ePay to the HikaShop payment log. Turn it on to look into a problem, then off again.
- **Cancel url**: optional, the page your customer is sent to when they cancel on ePay. Left empty, the standard HikaShop cancellation page is used.
- **Return url**: optional, the page your customer is sent to after a payment that confirms the order. Left empty, the standard HikaShop thank you page is used.
- **Invalid status**: shown for every payment method, but the current version does not set it from ePay messages.
- **Pending status**: the status of an order whose money is only reserved ("created" by default). It is the status you move the order from to capture the payment.
- **Verified status**: the status of an order once its money is taken ("confirmed" by default).
- The other settings of the page (name, description, images, price, zone, currency, restrictions) are the same as for every HikaShop payment method.

## Troubleshooting

- Turn **Debug** on and open the payment log (System > Configuration, Files, "See the report" next to "Payment log file") to see the messages ePay sends back.
- An email "Epay payment notification refused" with "hash mismatch": the Secret MD5 key of the payment method is empty or is not the one of your ePay account. Copy it again from Settings > Payment system.
- An email "Epay payment notification refused: invalid amount": the amount ePay reported is not the total of the order. Check the payment in your ePay administration; the order is not changed.
- "Transaction ID is missing from the order. The transaction's funds could not be captured automatically.": the order has no ePay transaction, so it can neither be captured nor refunded from the shop. Do it in your ePay administration.
- "The funds could not be captured" or "The funds could not be refunded": ePay refused the operation and the order status is not changed. The reason ePay gave is shown right after the message and written to the payment log. Check the web service password and that your server's IP address is allowed in ePay.
- "The subscription could not be cancelled.": ePay refused to delete the recurring payment; the details are in the payment log.