Shopware 6 Integration Guide

💳 Credit Cards

• Visa (Click to Pay), Mastercard (Click to Pay)
• American Express
• JCB, Diners Club

📱 Digital Wallets

• Apple Pay
• Google Pay
• Amazon Pay (v2)
• PayPal and PayPal Express
• PayPal v2 and PayPal Express v2
• Alipay
• WeChat Pay
• WERO

🏦 PAYONE Solutions

• PAYONE Secure Invoice
• PAYONE Secured Payments
• PAYONE Direct Debit
• PAYONE Open Invoice
• PAYONE Prepayment

🌍 Local Payment Methods

• Klarna Payments
• Ratepay Solutions
• Unzer Payments
• Bancontact, EPS, iDEAL
• PostFinance, Przelewy24

This payment method requires its own payment portal. Please enter a separate portal ID under Settings → Extensions → PAYONE → PAYONE Secure Invoice.

A rule created during the plugin installation for the Rule Builder ensures that the payment method can only be used for the currency "Euro". If you have not installed the currency "Euro" in your store during the plugin installation, a random, non-existing currency ID will be linked to the condition, so that the rule will always fail. If you then create the currency "Euro" afterwards, you have to select the currency "Euro" in the condition "Currency is one of" under Settings → Rule Builder → Payone secure invoice.

To inform their customers of the bank account details to which they should transfer, a bank details block was integrated into the invoice template.

To be able to offer Unzer, the payment methods must be additionally configured in the backend:

PAYONE Unzer Invoice Purchase

Under Settings → Extensions → PAYONE → PAYONE Unzer Invoice Purchase the following data must be stored: Company name (for the supplementary T&C), IBAN and BIC (both will be displayed next to the payment reference). Activate the B2B slider if you want to accept B2B orders.

PAYONE Unzer Installments

Under Settings → Extensions → PAYONE → PAYONE Unzer Installments the following data must be stored: Company name (for the supplementary T&C), channel name and channel password (both you get from Unzer).

In Settings → Extensions → PAYONE → PAYONE Apple Pay the following data must be provided: Supported card types, Apple Pay Merchant ID (Identifier in the Apple Developer Portal), Apple Pay Display Name (the name shown on the Apple Pay sheet), and Certificate Passphrase (if a password was set during the request.csr creation).

Create the following files in the config/apple-pay-cert/ folder: merchant_id.pem and merchant_id.key.

In addition, a subfolder .well-known must be created in the public folder. In this subfolder please put the file: apple-developer-merchantid-domain-association.txt

In addition to the configuration in Shopware, it is also necessary to set up the corresponding certificates to operate Apple Pay as a payment method. You can find instructions for this here: Special Remarks - Apple Pay

Additionally, Apple requires validation of the store domain for Apple Pay. To do this, follow the instructions in the Apple Developer Portal:

Preauthorized transactions can be captured using the "Capture" button in the order details.

The "Refund" button can be used to refund an order (in the "paid" status).

You can partially capture or refund an order by selecting an order item and editing the quantity. The capture amount is adjusted dynamically.

If you want to fully capture or refund the order, click "Complete Capture".

You can also directly enter the requested amount in the "Capture amount" field.

Captures and refunds are only possible after the store has received a transaction status for an order, therefore, the buttons for captures and refunds are grayed out directly after an order.

Under Settings → Extensions → PAYONE → Status Mapping you can individually assign the states to which the orders should be set as soon as the respective information is sent by the PAYONE platform.

Under Settings → Extensions → PAYONE you can individually assign the states for every payment method separately. Please choose the payment method and activate "Display state mapping configuration".

The following customizations are not necessary to offer credit card payments. The possibility to customize the payment type visually in the frontend is described in the following:

You can change the CSS by creating a new plugin that depends on this plugin via Composer. Here you can then define an overriding JavaScript plugin like this one:

Then you can register the overriding plugin in your custom/plugins/MyPlugin/src/Resources/storefront/main.js:

If you use Shopware's rights management, please give permission to all users. Under Settings → System → Users & permissions → Role create a new role or update an existing role. Activate the PAYONE transaction management right.