Important information


FAQs and known issues

Check your integration against the list below to make sure it’s complete.


Can I submit the Shopware 6 order number to the Unzer payment system?

No, you cannot submit the Shopware 6 order number to Unzer the payment system because:

  • The order number for Shopware 6 is a not a unique identifier for an order within shopware 6. For one Shopware order number, there can be several payment attempts. For each payment attempt, a unique order number should be submitted to the Unzer payment systems. Therefore, you cannot use Shopware 6’s order number as an unique identifier for your payment.
  • The Unzer Payment Plugin for Shopware 6 submits a Shopware 6-generated unique combination of numbers and letters to Unzer the payment system, that you can find in your admin overview table as Unzer Transaction ID. In Unzer Insights, it is called as the Order number and in your Unzer Invoice (ETN) as the Order number.

Where can I find the payment data for customers for invoice and prepayment payment methods?

You can find this information in the unzer_payment_transfer_info table within Shopware 6’s field. You will find the following fields for invoices within this table.

Parameter Description
IBAN The 16-digit account number for the specific customer bank account
BIC The unique 8 or 11 alphanumeric identifier for the customer’s bank
Holder The account holder of the bank account
Descriptor The purpose of the transaction (formerly known as Short-Id)
Amount The total amount the customer has to pay
icon info
In the future, these fields will be stored in an order-related custom field in Unzer Shopware 6 plugin.

Known issues

Bugs in plugin version 3.2.0 after declined transactions


After a declined transaction for Invoice Secured or Sofort, the customer gets redirected to a failure page instead of the checkout-success page with an error message of the plugin. You can also find an entry in plugin log file like:

plugin_unzer_payment.ERROR: Catched an API exception in UnzerPayment6\Components\PaymentHandler\UnzerInvoiceSecuredPaymentHandler::pay


You must install the plugin version 3.2.1, where this issue is fixed.