Login to your statistics area.

Not registered yet?


Maintenance on 02/25/2021 from 7:00 am to 9:00 am. This can lead to severe restrictions and failures in our services.

Maintenance on 02/25/2021 from 7:00 am to 9:00 am. This can lead to severe restrictions and failures in our services.

Maintenance work on February 25th, 2021 from 7:00 a.m. - 9:00 a.m.

Shopware 5 Shop Plugin
Quickstart guide

Shopware 5 integration of API payment methods

plugin version: 1.1.6 - 01/2021
Compatible with: ab 4.2.0
Shopware 5 API Shop-Plugin

Available payment methods for this shop version:


The following steps are necessary to implement the Micropayment payment modules. All the details on how to integrate them are covered in later sections of this manual.

  • 1

    Sign up for free of charge and without obligation in the Micropayment ControlCenter.

  • 2

    Use the Micropayment merchant access to create your project(s) under
    Configuration → Projects. The registered projects are reviewed by our risk team as quickly as possible.

  • 3

    Activate your project. After you have applied all the settings, all payment methods will be available in test mode.

  • 4

    Request the required payment methods via
    Customer data → Contract information → Payment methods.

  • 5

    Configure the desired payment methods under
    Configuration → Payment methods.

  • 6

    After your account has been authenticated, our service will be fully available to you for LIVE operation.

You can use all payment methods in test mode at any time. If you have any questions, our Support Team is always happy to help.


To install the payment modules, you will need to access the shop software files.
Connect to your web server’s file system for this, for example via FTP.

Begin installation:

The Micropayment Shopware plug-in can be installed directly through the Shopware system.
  • 1

    Log in via the JTL admin backend

  • 2

    Settings → Plug-in manager → Installed → Upload plug-in → Plug-in
    upload in .zip format

  • 3

    Once the plug-in has been installed, you need to activate it:
    Settings → Plug-in manager → Installed → Activate

Configure the payment modules in the Shopware 5 backend

Log in via the Shopware admin backend → Settings → Plug-in manager → Installed → Micropayment API Payment modules → Open → Configuration.
Micropayment Shopware 5 Plugin Konfiguration Einstellungen

Settings for the individual fields in the Micropayment configuration mask:

Project ID
Open the project in the Micropayment ControlCenter under Configuration → Projects and copy the project ID listed there.

Micropayment plug-in configuration settings

Access key
You can find the access key in the Micropayment ControlCenter under Configuration → Access key.

Configure the Micropayment access key

Test mode
Activates or deactivates test mode

Free text / payment reference
Description of the order for the customer’s payment reference. If left blank, only the order number [orderId] will be used. Optionally, you can add your own text. Example: Order: {$orderId}.

3-D Secure
Activates 3-D Secure for credit cards for the 1st payment only or for all payments.

Use titles to define how you want the payment method to be displayed in the checkout process (e.g.: “Direct debit” or “SEPA direct debit”).

Shopware 5 Zahlungsarten Beschreibung

Additional description
Short description of the payment method and its functionality.

Payment method configuration in the Micropayment ControlCenter

Credit card / SEPA direct debit / prepayment

Micropayment - Project settings
Before you can use the Micropayment payment plug-in, you have to apply some settings in the Micropayment ControlCenter.

Settings must be applied for all payment methods you intend to use. Credit card, SEPA direct debit and prepayment have different configurations from the other payment methods.

Configure payment method:
To configure the payment method, go to Configuration → Payment methods and select Credit card → API.Event / Direct debit → API.Event / Prepayment → API.Event.

Configure Micropayment payment methods

Notification URL:
Enter the following notification URL here:

Direct debit
Direct debit


Bank Transfer
Bank Transfer

Activate the payment method
To do this, click on “Information on using the API” and agree to the information. Save your settings.

Activate the Micropayment payment method

Access authorisation
You need to authorise communication between your shop and Micropayment. To do this, open Configuration → Access authorisations and then select “New access authorisation”. Enter the IP address of your shop server here.

Micropayment access authorisation

The configuration in the Micropayment ControlCenter has been completed.

We hope you enjoy your Micropayment plug-in.

Integration made easy.

Do you have questions about our payment methods or about the use of our systems? Please contact us by e-mail. We will reply as soon as possible.

(0800) 5 770 371

free of charge from German landline

  • Carsten Keßel - Micropayment GmbH

    Carsten Keßel

    senior support engineer

  • Jessica Amberg - Micropayment GmbH
    finance office

    Jessica Amberg

    head of controlling

  • Robert Kühn - Micropayment GmbH

    Robert Kühn

    senior support engineer