Shopware
Use this guide if your webshop runs on Shopware 6.
The Shopware plugin is the fastest way to connect your store to ePay without building a custom integration. You install the plugin, add your ePay credentials, connect a Point of Sale and place a test order.
What you will do
In this guide, you will:
Before you start
You need:
- A Shopware 6 installation
- Access to Shopware Admin
- Access to ePay Backoffice
- An API key
- A Point of Sale
- A webhook verification key
If you still need your credentials, see Set up your account.
Before installing a new plugin on a live shop, take a backup first.
Step 1: Install the plugin
You can install the plugin either by uploading a ZIP file in Shopware Admin or by using Composer on the server.
Option A: Upload the ZIP file
Download the plugin ZIP file:
epay-main.zip
Go to Extensions -> My Extensions
Click Upload extension
Click Install
Click Activate
Option B: Install with Composer
SSH into the server and go to the Shopware root directory.
Run:
composer require tigermedia/epaybin/console plugin:refreshbin/console plugin:install --activate epaybin/console cache:clearThis installs the plugin, makes Shopware discover it and activates it.
Step 2: Open the plugin settings
After installation, open:
Extensions -> My Extensions
Find the ePay plugin and click Configure.
This is where you connect Shopware to ePay.
Step 3: Add your ePay credentials
In the plugin configuration, add:
| Value | What it is used for |
|---|---|
| Sales Channel | Chooses which Shopware sales channel should use the plugin |
| API key | Connects Shopware to your ePay account |
| Webhook verification key | Lets Shopware verify incoming webhook calls |
| Point of Sale | Tells ePay which webshop or sales channel the payment belongs to |
Save the configuration after entering the values.
If your setup supports separate test and live values, make sure you do not mix them.
Step 4: Find the values in ePay Backoffice
You can find the required values in ePay Backoffice:
Log in to app.epay.eu
Go to Developers to find or generate your API key
Go to Point of Sale to find the Point of Sale you want to use
Open the Point of Sale and find the webhook authorization or verification value
Copy each value into the Shopware plugin configuration and save again.
Step 5: Connect the right sales channel
Choose whether the plugin should apply to one specific sales channel or all sales channels.
If you are testing, start with one sales channel first. That makes it easier to validate checkout behavior before enabling the plugin more broadly.
Step 6: Place a test order
Go through your storefront like a normal customer:
After the payment finishes, the customer should return to your Shopware storefront.
Step 7: Check the result
Confirm that:
- The payment method appears correctly in checkout
- The order was created in Shopware
- The payment was attached to the correct order
- The order status changed as expected
- The transaction is visible in ePay Backoffice
Common problems
The payment method does not appear in checkout
Check that:
- The plugin is installed and activated
- The correct sales channel is selected
- The API key is correct
- The Point of Sale is correct
- The plugin configuration was saved
The plugin is installed, but Shopware does not pick it up
Check that:
composer requirecompleted successfully, if you used Composerbin/console plugin:refreshwas runbin/console plugin:install --activate epaywas run- Cache was cleared after installation
Payments start, but the order is not updated correctly
Check that:
- The webhook verification key is correct
- Shopware can receive the payment result correctly
- Your store is publicly reachable during testing
- The order status behavior matches your Shopware configuration
The wrong sales channel uses the plugin
Check that:
- The selected sales channel in the plugin matches the storefront you are testing
- You did not leave the plugin on all sales channels by mistake
What you built
You have now connected Shopware 6 to ePay and completed your first test payment through the plugin.
Before going live, also test:
- A successful payment
- A failed payment
- A cancelled payment
- The full customer return flow
- The behavior for the sales channel you plan to use in production