Payment Methods


These settings allow you to add, edit, activate or deactivate various payment methods in your shop. The configuration window can be found by following Configuration > Payment methods in your backend.

An overview of available fields is as follows:

Available payment methods

Under the column Available payment methods you will see all active and inactive payment methods. The number in brackets after the selected payment type is the internal system ID of the payment type.
The payment types are first sorted by active or inactive and then by the system ID.

Adding a payment method

Click on the Add button to quickly add a new payment method. After creation, the new method will appear in the Available payment methods column.

Delete a payment method

Use the left mouse button to select the payment type to be deleted in the left column. Then click on the Delete button. However, you should only delete a payment method in exceptional cases. We recommend to deactivate payment methods only! All customer accounts and orders that are linked to this deleted payment method can no longer be processed via the backend.

A payment method should never be deleted, as it can contain various references to customers, orders and backend modules. If a payment method is not needed, it should be deactivated first. This is especially true for payment methods that are delivered with shopware.


This is where you enter the settings of your payment method.

  • Description: name of the payment method in the front and backend
  • Name: the internal system name
  • Template: the name of the template file for the payment method
  • Class: the file name of the system class
  • Database Table: optional for additional database tables
  • Additional Description: information that will be displayed in the frontend. This can be translated for each of your shops by clicking on the globe icon.
  • Surcharge / discount %: global, percentage-based surcharge added during the checkout process
  • Fixed surcharge: global, absolute surcharge added during the checkout process
  • Position: placement of the payment method in the frontend / checkout
  • Active: whether the payment method is activated
  • Active for ESD items: whether the payment method is available at checkout with ESD items
  • Disable for smartphones: exclude this payment method from purchases made with smartphones
  • URL for iFrame: URL for an optional iFrame element in the checkout process

You can assign absolute or percentage-based surcharges for the payment method, however both methods cannot be used simultaneously. Should both options be required, it is possible to make changes to the shipping module, were you can define additional surcharge shipping rules.

Country assignment

Select the availability of the payment method for individual countries. Activate the country’s respective checkbox to assign it to the payment method. Should a country not be listed, it can be added in basic settings under Shop settings > Countries.

At least one payment method (likely the default) cannot have any restrictions. We recommend assigning the most popular payment method of your specific target market as the default method.

Country specific surcharges

Under the ´Surcharge tab you can create land-specific surcharges for the payment method. Available countries are those which you have already assigned in the Country tab. Double click the Surcharge column to assign an absolute value surcharge.

Subshop assignment

Here you can activate or deactivate the payment method for individual subshops.

At least one payment method without any restrictions must be present in the system.

Using Risk management, you can assign a network of rules for each payment method in order to protect yourself against default payments. For instance, certain payment types can be locked when an order comes from abroad, an order amount is below X, an order is made from category XY, etc. For more information on this topic, see our Risk management wiki.

Payment methods in basic settings

Fallback payment method

Shopware uses the fallback payment method when other types cannot be used for an order. You'll need to set up the ID - out of the box it is filled with the ID of "debit payment". You can easily find the ID in the settings of the payment types. You can see the ID in brackets after the name of the payment type.

Standard payment method

Please fill in the ID of the payment type you want to offer your customers in default. It's not related to the fallback payment type.

It's very important to choose a payment type that can be used by every customer.

SEPA configuration

SEPA is the european successor of the classical debit payment, it handles debit payments euro-wide in the same standard. SEPA data are made of an IBAN and a BIC: The IBAN identifies the country, the bank code and your account number, the BIC identifies the bank only. With this payment method you can offer it directly to your customers. We'll show you in this article how that works.

In these settings, you can configure the basic informations for the SEPA debit. In addition to the config fields and the decision, which should be required, you can also configure your companys data which are used later in the SEPA mandate PDF.

All the other texts are snippets, which allow you to edit the whole document in the snippet module.

Shopware is not made for archiving or tracking these mandates. Shopware can send the mandates for you to the customer automatically, but make sure that you find a solution for sending and receiving mandates, which fits your needs. For sure you can use existing payment interfaces, which may do this for you. Sending the mandate can be deactivated in Shopware, so you are able to manage this process on your own way.

Basic settings

  • Creditor name: Is used in the mandate
  • Header text: Is used as header of the mandate
  • Creditor number: Enter your creditor number here
  • Send email: This sends the mandate automatically to the customer, when he pays with SEPA
  • Show SEPA's BIC field: (yes / no)
  • Require SEPA's BIC field: Mark BIC field as required (yes / no)
  • Show SEPA's bank name field: (yes / no)
  • Require SEPA's bank name field: Mark bank name field as required (yes / no)

Example from the storefront


In "Configuration > Email templates > System Emails" you can find the email template named "sORDERSEPAAUTHORIZATION".

If "Send email" is set to yes, the customer will get this email with the PDF mandate attached.

Example PDF


How can I switch to SEPA?

The SEPA payment method is a seperate payment method, which needs to be configured and activated seperately. The Shopware known payment "debit" can be disabled.

Is the data transmission encrypted?

If you have configured your Shop with SSL, the transmission is encrypted.

Do I have to adjust the mandate?

The mandate is designed by the given guidelines and contains all informations which are needed. You only have to configure your creditor number, creditor name and if needed the header. After that, the mandate is ready top use.

Will old debit data be migrated?

Old debit data will not be migrated, the customer has to re-enter his SEPA data at the first order with this payment method.

Are my customers notified automatically?

Every shop owner handles this in his own way. If you have announced this switch already, we surely won't do this another time. This way, we let you do this announcement your own way.

Where can I find the template for the SEPA PDF?

You can find the SEPA PDF template here: engine/Shopware/Plugins/Default/Core/PaymentMethods/Views/frontend/plugins/sepa/email.tpl

Was this article helpful?