Switch from ePay Classic to our new platform

Go to app.epay.eu/register. Registration is free and does not require a payment card while you test.

1. Enter your email address, company name, and webshop domain.
2. Confirm your email address using the link we send you.
3. Enter your full name and choose a password.

You can then sign in at app.epay.eu/login.

You only need to complete three fields. The Backoffice for our new platform is separate from Classic Backoffice, so you can keep both open in different tabs while you work.

Your account starts in the test environment. Nothing needs to be activated yet.

The environment selector in the top-right corner is where you will later switch from Test to Live. Test and live are separate configurations, and your account remains in Test until we activate it.

You do not just receive two API keys. You also receive two Points of Sale: one for Test and one for Live. Each Point of Sale has its own ID and webhook authorization. These are the three credentials you need for the plugin.

A Point of Sale is the store a payment belongs to. If you have one webshop, you normally have one Point of Sale in each environment. This is also where your domain and payment window are configured.

Your test setup remains available after you go live. You can switch back to Test at any time to try changes without affecting real payments.

There are three credentials to find. Two are together in the Your credentials panel on the dashboard, and the third is on the Point of Sale. Start from the dashboard.

For now, just locate them. In the next step you can copy them one at a time while the plugin settings are open in another tab.

You can also find them in the menu

The API key and Point of Sale ID are also available from the left-hand menu:

Find the API key under Developers → API keys. Select the copy icon next to the key to copy it.

The Point of Sale ID is shown in the rightmost ID column.

Check your domain while you are here

Under Payment → Points of Sale, confirm that your webshop domain is listed in the Domain column. The domain is required for live payments; if it is missing, the payment window will not open in the live environment. This is the most common cause when the live payment window does not open.

If the domain is incorrect or was entered incorrectly during registration, contact Support and we will correct it for you.

Find the webhook authorization

After a payment is completed, ePay sends a notification to your webshop. This is what updates the order status, so you do not have to update orders manually. The notification includes an agreed secret, which lets your webshop verify that the notification came from ePay.

The secret is called Webhook authorization. It is on the Point of Sale, not on the dashboard. Open the relevant Point of Sale under Payment → Points of Sale, select Webhook authorization, then reveal and copy the full value.

Choose your webshop platform below. Its dedicated guide covers installation in detail; when you return here, use the test API key, Point of Sale ID, and webhook authorization from the previous section.

WooCommerce

WordPress webshop plugin

Magento 2

Composer-based Magento module

Shopify

Hosted app for Shopify checkout

PrestaShop

Module for PrestaShop stores

Shopware

Plugin for Shopware 6

OpenCart

Extension for OpenCart 4

WooCommerce example

In WordPress, search for epay under Plugins and install ePay Payment Solutions.

The screenshots below are from WooCommerce. Other platforms look different, but the credential fields use the same names.

Add your credentials

Keep Backoffice open in one tab and the plugin settings in another. Then complete the fields one at a time:

1. Enable Activate module.
2. Copy the API key from Backoffice and enter it in API Key.
3. Copy the Point of Sale ID and enter it in PointOfSale ID.
4. Copy the webhook authorization from the Point of Sale and enter it in Webhook Authorization.
5. Save the settings.

The payment title and description are displayed to customers at checkout and can be adjusted later. The webhook authorization is important: if it is empty, the webshop accepts notifications without verifying their sender. If it is incorrect, the webshop rejects the notification and the order may remain unpaid even though the customer has been charged.

Magento 2 example

In Magento, open Stores → Configuration → Sales → Payment Methods, then expand ePay Payment. Webhook Authorization is directly below PointOfSale ID, and the credentials are entered in the same order.

It is expected that both the Classic payment method and the payment method for our new platform are visible in your shop at this stage. Leave both enabled until our new platform has been tested.

Complete checkout as a customer would and select the payment method for our new platform.

Use one of these test cards; no money is charged in the test environment. Use any future expiry date and any CVC for each card.

Brand

Card number

Expiry

CVC

Dankort

5019 0005 0000 0003

Any future date

Any CVC

Visa

4454 0000 0000 0003

Any future date

Any CVC

Mastercard

5451 0000 0000 0003

Any future date

Any CVC

For declined payments and 3D Secure flows, see Test cards.

After the payment, confirm that:

If the payment succeeds but the order does not update, compare the plugin's webhook authorization with the value on the Point of Sale. Your webshop must also be publicly reachable so it can receive the payment result.

This is where we need to step in. Your account must be active before you can accept live payments.

Once the test order works, contact support@epay.dk or call +45 9813 9040. We will:

• activate your live account;
• add your acquiring agreements to the new account.

We will let you know when you can continue.

When we activate the account, your live Point of Sale, live API key, and live webhook authorization are created automatically. You do not need to create them, but you must retrieve the new credentials and update the plugin in the next step.

After activation, select Live in the Backoffice for our new platform. The test banner disappears, and you now have a new set of credentials: a live Point of Sale, live API key, and live webhook authorization.

Retrieve the live API key from Developers → API keys; the live Point of Sale ID from Payment → Points of Sale; and the live webhook authorization from the Point of Sale itself. Then replace every value in the plugin.

Check that the live Point of Sale has the correct domain. Test and live are separate setups, so the domain does not automatically carry over. Also compare the live webhook authorization with the plugin value: if they differ, orders can remain unpaid even after the customer has been charged.

Make a real payment for a small amount with your own card and refund it afterwards. This verifies that the complete live setup works.

Only after the live payment succeeds, disable the Classic payment method in your webshop. This sends new payments through our new platform.

Do not deactivate or remove the Classic plugin yet. Existing Classic orders still rely on it for captures and refunds.

Orders paid through Classic remain on Classic. Capture or refund them as you normally would, and keep using Classic Backoffice until they are finished.

When every Classic order has been captured or refunded, remove the Classic plugin. If you are unsure whether you have reached that point, leave it in place: an inactive plugin does no harm.