Set up ePay as a payment gateway

ePay is one of the payment gateways that Shoporama supports. With ePay you can accept card payments, MobilePay Online, Klarna, Forbrugsforeningen and a wide range of other payment methods. Here's a complete guide to setting it up.

Step 1: Create gateway in Shoporama

1. Log in to your Shoporama admin panel
2. Go to Store " Integrations " Payment gateways
3. Click Create new payment gateway
4. Select ePay
5. Give it a descriptive name, e.g. Credit card
6. Click Save

Step 2: Fill in the Merchant ID

In the Merchant ID field, enter your Merchant ID from ePay. You can find it in the ePay administration panel in the top right corner or under Settings " Payment system. It is typically a 7-digit number.

Step 3: Fill in Secret (MD5 secret)

The Secret field is an MD5 secret that ePay uses to sign callbacks. It ensures that Shoporama can verify that a payment message actually comes from ePay and not from an outside party.

You can find it in the ePay admin under Settings " Payment system " MD5 stamp/key. You choose which string to use. The important thing is that you enter exactly the same value in ePay and in Shoporama.

Step 4: Password (for capture)

If you want Shoporama to automatically collect payments when an order is sent, you need to fill in the Password (for capture) field.

This is a so-called Remote password that you find in the ePay admin under Settings " Payment system " Remote password. It is used to authorize the API calls Shoporama makes when a payment is to be charged or refunded.

Step 5: Add your domain in ePay

ePay requires you to whitelist the domains that can use the payment window. If your domain is not approved, you will see the error "The referring domain is not allowed".

1. Log in to the ePay admin panel
2. Go to Settings " Payment system
3. Find the field with allowed domains
4. Add your domain (e.g. www.dinshop.dk)
5. Also add dinshop.shoporama.dk if you are still using the Shoporama subdomain

Step 6: Automatic capture (optional)

If you want the money to be automatically captured when the order is shipped or picked up, you can check "Automatically capture money when the item is shipped or picked up". This requires that you have filled in the Password (for capture).

The amount will be reserved on the customer's card immediately, but will only be withdrawn when you mark the order as shipped or picked up. This is the recommended setup for physical goods, as Danish law does not allow you to withdraw money before the item has been shipped. Read more in our guide to withdrawing payments on orders.

Step 7: Save and test

Click Save in Shoporama. Then test that the payment works by creating a test order in your online shop.

To see the real payment window, your shop must be set to live. In demo mode, a simplified screen is shown instead. See the FAQ below for more info.

Advanced settings

The ePay gateway has a number of advanced settings that most people don't need to change:

• Windowstate: controls how the payment window is displayed (1 = same window, 3 = overlay, 4 = full page, recommended)
• Window ID: ID for a customized payment window design created in ePay
• Group: group transactions under a common name in ePay
• Language: 1 = Danish, 2 = English, 3 = Swedish
• Card type: limit to one specific card type (e.g. Dankort or MobilePay Online only). Leave blank to allow all enabled card types
• Payment group: filter payment methods by category (card, gift card, online banking, invoice, mobile, etc.)
• Add invoice data: send order lines and customer details with the payment. Required when using Klarna
• CSS URL: URL to external stylesheet that customizes the appearance of the payment window
• Google Tracker: Google Analytics tracking ID to track payment flow

Frequently asked questions

What are the minimum fields I need to fill in?

As a minimum, you need to fill in Merchant ID and Secret. If you want to automatically withdraw and refund payments, you also need to fill in Password (for capture). The other fields can be left blank and will use default values.

Where do I find the MD5 secret in ePay?

Log in to the ePay admin and go to Settings " Payment system. Here you will find the field "MD5 stamp/key" (or simply "MD5-key"). You can choose which string to use. The most important thing is that you set exactly the same value in ePay and Shoporama.

Can I offer MobilePay and Klarna via ePay?

Yes. ePay supports MobilePay Online (payment type 29), Klarna (payment type 17), ViaBill and many other methods. They must be enabled on your ePay agreement first. Using Klarna also requires you to enable Add invoice data so that order lines are sent with it.

Can I accept the Consumers' Association via ePay?

Yes, you can. The Consumers' Association is activated as card type 11 in your ePay gateway. If you want to offer both cards and the Consumers' Union, you can create two ePay gateways in Shoporama with the same keys but different card types. Read the full guide on Consumers' Union as a payment method.

How do I refund an order?

If you have filled in the Password (for capture), you can refund a payment directly from the order view in Shoporama via a credit note. Read our guide to credit notes and refunds. If you are missing the Remote password, the refund must be done manually in ePay-admin.

Why don't I see the payment window?

There can be several reasons:

• The shop is in demo mode. The payment window only appears when the shop is set to live. In demo mode, you see the text "Pretend to pay" instead.
• Missing SSL. The payment window requires your shop to run over HTTPS. Shoporama automatically creates an SSL certificate when your domain is set up correctly.
• Incorrect Merchant ID. Check that you have entered the correct Merchant ID from ePay.

I get the error "The referring domain is not allowed"

This error means that the domain you are using is not authorized in ePay's admin. Log in to ePay and add your domain under Settings " Payment system. Remember to add both your own domain (e.g. www.dinshop.dk) and possibly your Shoporama subdomain (e.g. dinshop.shoporama.dk).

Can I test payment with a test card?

ePay provides test merchant numbers and test cards that you can use to test the payment flow. However, please note that the payment window only appears when the shop is set to live, not in demo mode.

Alternatively, you can make a test purchase with a real card on a cheap product and then refund the payment in ePay's admin.

What is the difference between demo mode and live?

In demo mode, Shoporama simulates the payment so you can test the rest of the checkout flow (cart, delivery details, order confirmation) without involving ePay. In live, the customer is sent to the real ePay payment window to pay by card, MobilePay or other payment methods.

Is it ePay, Bambora or Worldline?

ePay was originally acquired by Bambora, which later became part of Worldline. Since December 2024, ePay is again an independent company. The correct name is simply ePay.

Do I get the money directly into my account?

No. ePay is a payment gateway, not an acquirer. The money is paid by your acquirer (e.g. Nets, Clearhaus, Teller) to your business account at an agreed settlement frequency. ePay simply sends the card data securely to the acquirer. Read more about when you get your money paid out.