alt

Important information

Unzer
search

    Set up your payment methods

    Set up the payment methods that you want to offer to your customers.

    Before you begin

    Step 1: Configure payment methods

    1. Login with your admin credentials and go to Settings > Shop > Payment. Payment method configuration
    2. Select the payment type you want to update and click Edit.
    3. Edit the payment type according to your requirements as described in the table below. single payment method configuration
    Field Description
    Name You can change the payment type name displayed in the storefront
    Position Determine the display order for the end customer in shop frontend
    Description Add the additional description text, if required.
    Logo Add a logo for the payment method, if required.
    Availability rule Select the Availability Rule (Rule builder) to determine when the payment type should be available to the end customer (country restrictions, customer groups, etc.)
    Active Activate the payment method to be visible in the store front end.
    Allow payment change after checkout? Select this option if the payment type must still be selectable for the end buyer after a payment cancellation or rejection.
    1. Click Save to save your settings.

    Step 2: Setup your payment methods for sales channel

    1. Go to the Sales channel configuration for which you want to activate the payment methods. Sales channel configuration
    2. Select the payment method that are available for you.

    icon
    You can only use the payment methods that are specified in your contract with Unzer. Even if you can edit the other payment methods, they will not be reflected in Unzer Insights.
    3. Select your default payment type.
    4. Select Save.

    You must clear the caches each time you update the configuration. See also Step 3: Configure your plugin environment

    Specific payment method requirements

    Some restrictions for using individual payment types of the plugin. You can easily create these using the Shopware Rulebuilder and then apply them across your payment method setup.

    Payment method Requirement
    Apple Pay
    • You require an Apple device to test the integration.
    • For the payment type Apple Pay, make sure to add the necessary certificates as specified here.
    • You need an Apple Developer account for the integration.
    • When you change your key pair, you need to re-upload your Apple Pay Payment processing certificate.
    • Currently, Apple Pay is only supported for Safari web browser upto iOS 15.
    • If you want to use Apple Pay for other web browsers, you must update to iOS 16 on your apple device.Go to the Apple Pay site for the latest updates and news.
      iDEAL
      • For the payment type iDEAL, make sure that only end customers with a billing address from the Netherlands can use the payment type.
      EPS
      • For the payment method EPS, make sure that only end customers with a billing address in Austria can use this payment method.
      PostFinance
      • For the PostFinance payment type, ensure that only end customers with a billing address from Switzerland can use the payment type.
      • For the PostFinance payment method, also ensure that only the Swiss Franc (CHF) currency is used for the payment method.
      Przelewy24
      • For the Przelewy24 payment method, ensure that only end customers with a billing address from Poland can use the payment method.
      • For the Przelewy24 payment method, also ensure that only the currency Zloty (PLN) is used for the payment method.
      Unzer direct debit guaranteed / secured
      • For the Unzer Direct Debit payment method, ensure that only end customers with a billing address in Germany, Austria and Switzerland can use the payment method.
      • For the Unzer Direct Debit payment method, also ensure that only the currency Euro (EUR) and Swiss Francs (CHF) can be used for the payment method.
      Unzer invoice (deprecated)
      • For the payment method Unzer Invoice (deprecated), ensure that only end customers with an invoice address from Germany and Austria can use the payment method.
      • For the Unzer Invoice Purchase payment method, also ensure that only the currency Euro (EUR) can be used for the payment method.
      • For the Unzer invoice purchase payment method, also ensure that the payment method can only be used in the minimum/maximum amounts contractually agreed with Unzer.
      Unzer invoice | Unzer Payment Depending on your agreed contract with Unzer
      • For the payment method Unzer Invoice, ensure that only end customers with an invoice address from Germany, Austria or Switzerland can use the payment method.
      • You require a unique key pair for each customer type and currency combination, for example a separate key pair for B2C (CHF) and a separate key pair for B2C (EUR).
      • Currently only Euro (EUR) and Swiss Franc (CHF) currencies are supported.
      • Ensure that the payment method can only be used for the minimum to maximum amounts contractually agreed with Unzer.
      • You cannot see the transactions in Unzer Insights but require a separate portal access to view transactions. Contact Unzer to get access to this merchant portal.
      • You must generate an invoice in the Shopware 6 back end before you can charge the payment. This ensures that the insurance period is initiated.

      Next steps

      See also

      Shopware 6 documentation