Shopware 5 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 Invoice, Secured Direct Debit and Secured Installments
• PAYONE Direct Debit
• PAYONE Open Invoice
• PAYONE Prepayment

🌍 Local Payment Methods

• Klarna Payments
• Ratepay Invoice, Direct Debit and Installments
• Unzer Invoice, Direct Debit and Installments
• Bancontact, EPS, iDEAL
• PostFinance Card and E-Finance
• Przelewy24

Click under Customers → Payments → PAYONE Control Center → Payment methods → Direct Debit

Click under Customers → Payments → PAYONE Control Center → Payment methods → Apple Pay

Click under Customers → Payments → PAYONE Control Center → Payment methods → Credit Card

Custom Display for Hosted iFrames

Our plugin offers you compliance with the "lowest" PCI DSS compliance level (SAQ A). You can customize the iFrame fields using various styling options.

Click under Customers → Payments → PAYONE Control Center → Payment methods → Credit Card (Click to Pay)

Enter the DPA ID here. You will receive this from PAYONE. In the settings, you can enable or disable Click to Pay. You can also decide whether customers are allowed to register for Click to Pay.

Click under Customers → Payments → PAYONE Control Center → Payment methods → PayPal Express

Click under Customers → Payments → PAYONE Control Center → Payment methods → PayPal Express V2

Click under Customers → Payments → PAYONE Control Center → Payment methods → Ratepay

To ensure the Ratepay payment method functions smoothly, you need to enter some additional configuration data provided by Ratepay. Use the "Add" button to add more Ratepay configurations.

Save the configuration and then retrieve the data from RatePay by clicking on "Retrieve Ratepay Configuration."

These two payment methods require their own payment portal. Please navigate to Customers → Payments → PAYONE Control Center, select the payment methods: PAYONE Secured Invoice Purchase and PAYONE Secured Installment Purchase, and enter a separate Portal ID for each.

Capture

Under Customers → Orders you can enter pre-authorized orders. To do this, you need to edit the respective order by clicking on the pen.

The items to be captured must be marked (checkmarked) and then confirmed with the "capture position" button.

Refund

Under Customers → Orders you can create credit notes. To do this, you need to edit the respective order by clicking on the pen.

Marking of Conspicuous Orders

If there are discrepancies in an order, the order will be marked with the status "Verification required". In this case, the amount in Shopware 5 should be checked with the amount in PAYONE Merchant Interface (PMI), as this could be a fraud attempt.

You can use the following options only if you have ordered the Protect module from PAYONE. The use of address checks is associated with variable costs per transaction.

Under Customers → Payments → PAYONE → Configuration → sheet "address check" you can define if and in which form the address checks should be performed and how the Shopware eShop should behave if certain results apply.

You can use the following options only if you have ordered the Protect module from PAYONE. The use of credit checks is associated with variable costs per transaction.

Under Customers → Payments → PAYONE Control Center → Configuration → sheet "credit assessment" you can specify whether and in what form the credit checks should be performed.

Under Customers → Payments → PAYONE → API-Log you will find all information about the processed payments and communication with the PAYONE platform.

Under Customers → Payments → PAYONE → Transaction Status-Log you have an overview of the transaction status messages received and can view details by clicking on a record.

Risk Management

With the PAYONE plugin for Shopware, you can control which payment methods are offered to your customers depending on their creditworthiness. Under Configuration → Risk management you can determine whether a payment type is blocked based on a defined traffic light value.

Shipping Costs

To ensure smooth operation of the plug-in, it is necessary to assign shipping rates to each payment method. As a further option, you can define an alternative shipping type that always takes effect if no concrete shipping cost record is assigned to a payment type.

Customizing Snippets

For the display of certain texts, text modules have been provided with the installation of the plug-in, which you can adapt according to the language used in each case. You find the administration of the snippets under Configuration → Snippets.

Duplicate Payment Method

Under Configuration → Payment methods you can copy the payment methods for separate use, with a subshop or other reasons such as country assignments.