Shopware Payments
Shopware Payments lets you manage supported payment methods and transactions directly in the Shopware Administration. This guide covers requirements, setup, going live, and troubleshooting.
Availability depends on your Shopware version. Before you begin, review the installation instructions.
Quick start
Shopware Payments overview with account and management areas.
Check your Shopware version, merchant country, and account requirements.
Activate Shopware Payments or install the app, depending on your version.
Connect a Shopware Payments account or select the provided test account for testing.
Assign the desired account to the correct sales channel.
Configure available payment methods and activate the ones you want to offer.
Test checkout and order processing before switching to a production account.
Shopware Payments is built on PayPal infrastructure and managed in the Shopware Administration. It does not replace existing payment service providers; you can continue using external providers.
Requirements and availability
Supported versions
| Shopware version | Minimum version | Provided as |
|---|---|---|
| 6.5 | from 6.5.7.0 | App |
| 6.6 | from 6.6.3.0 | App |
| 6.7 | as a service from 6.7.1.0 | Shopware Services |
Merchant and regional requirements
You need a valid Shopware installation.
You need PayPal Business Services in a supported region.
Depending on your business model, additional verification and compliance checks may be required.
Shopware Payments is currently available to merchants in Germany and Austria. Additional EU markets and the United States will be added gradually.
Plans and support
Shopware Payments is available with the Community Edition and the Rise, Evolve, and Beyond plans. Support and response times depend on your plan. For current terms, see the linked Shopware plan and support information.
Activate or install Shopware Payments
Shopware 6.7.1.0 and later
In the Shopware Administration, go to Settings > System > Shopware Services.
- Activate Shopware Payments.
- Open Shopware Payments from the main navigation, or go to Settings > Payment methods > Shopware Payments.
- Start onboarding.
Shopware 6.5.7.x to 6.6.10
- Open the Shopware Administration.
- Go to Extensions > My Extensions > Apps.
- Search for Shopware Payments.
- Install and activate the app.
- Then start onboarding.
Note: Menu names and availability may differ by Shopware version. If your Administration looks different, follow the installation instructions for your version.
Connect an account and assign sales channels
A connected account processes payments for the sales channels assigned to it. Check the assignment carefully, especially if you operate multiple brands, country-specific shops, or separate B2B and B2C channels.
Add an account
Start connecting another account.
Go to Shopware Payments > Settings > Accounts.
Click Add Account (1).
- Select the country where your business is registered.
- Click Start onboarding and follow the on-screen steps.
During onboarding, a PayPal Business account is created or an existing account is linked. Depending on your country, business type, and account status, you may need to provide business, contact, and tax details, information about beneficial owners, or verification documents.
- Select the connected account in the account overview.
- In the Sales Channels field, select one or more channels.
- Make sure each channel is assigned to the intended account.
You can assign one account to multiple sales channels, for example, to use the same payment connection for several storefronts or language shops. An incorrect assignment may route payments through an unintended account.
Account status and management
The Active status means the account is connected and ready to process payments. Use Manage Account to manage account information, business details, payout information, and verification requirements, depending on your account.
Test your setup in test mode
Shopware Payments provides a test account. You do not need a separate sandbox account or test credentials. Transactions in test mode are simulated; no real payments are processed.
In Shopware Payments settings, open the Assignment (1) tab.
For the desired sales channel, click Details (2).
Open the drop-down menu and select Test mode (3).
Test checkout and order processing in that sales channel. First select the payment methods you want to test from the list.
Accounts in test mode are marked with the status Test. To go live, assign a production account to the sales channel. Check the assignment before switching so payments are not left in test mode or routed through the wrong account.
Manage payment methods
Go to Shopware Payments > Settings > Payment Methods. Here you can view each payment method’s status, edit its settings, and choose whether to offer it at checkout.
Available payment methods
Available methods depend on your account and supported countries. Options may include PayPal, Pay Later, Pay upon invoice (purchase on account, available to merchants in Germany), Klarna, credit or debit cards, Apple Pay, Google Pay, Bancontact, SEPA Direct Debit, Venmo, BLIK, and EPS.
Check availability: Not every method is available for every merchant country, customer country, or currency. Availability also depends on account approvals and provider requirements. The list above does not guarantee that every method is available in your shop.
Payment method status
| Status | Meaning | Next step |
|---|---|---|
| Additional data required | Setup is incomplete. | Provide the missing information or complete the setup steps. |
| Blocked | This payment method is currently unavailable. | Check account approvals, restrictions, and requirements. |
| Under review | The submitted information is being reviewed; the method may not be available yet. | Wait for the review to finish, then check the status again. |
| Active | The method is set up and can be offered to customers. | Also check that it is enabled and available in the relevant sales channel. |
Click Edit to open a payment method’s detailed settings. Depending on the method, additional options such as country-specific settings may be available. Use the Active toggle to control whether customers see the method at checkout. Disabling a method does not affect existing orders.
General settings
Go to Shopware Payments > Settings > General. You can apply many settings to all sales channels or to an individual channel. First select where the settings should apply.
Payment collection
| Option | Effect | Typical use |
|---|---|---|
| Manual collection | The amount is authorized and reserved; it is captured later. | Review orders before shipping or capture payment after shipment. |
| Automatic collection | The amount is captured immediately. | Use this when payment should be captured during checkout. |
Save payment methods (Vaulting)
Enable Vaulting to let customers securely save supported payment details for future purchases. Supported methods include credit cards, debit cards, and PayPal. To use recurring PayPal payments, for example for subscriptions, enable Vaulting for PayPal.
Security: 3D Secure
When Block transactions without 3D Secure is enabled, payments without successful 3D Secure authentication are declined. This can improve security and reduce fraud and chargeback risk. Not all cards support 3D Secure, particularly cards issued outside the European Economic Area (EEA). If many of your customers are international, this setting may reduce card acceptance. Check whether it suits your target markets.
Text details
Fields for information displayed to customers.
Brand name: Enter your brand or company name. It may be displayed during checkout.
Customer service instructions: Provide information for customers who need assistance, such as a link to your contact or help page.
Express Checkout
PayPal Express Checkout is available starting with Shopware 6.7.4.0. You can choose where the button appears: product detail pages, cart, off-canvas cart, login page, and listing pages. Due to technical limitations of the app system, this feature is not available in earlier Shopware versions.
Pay Later banners
Pay Later banners inform customers about available financing and installment payment options. You can display them on product detail pages, in the cart and off-canvas cart, on login and listing pages, and in the footer.
Button appearance and saving
You can set the color, shape, and language of PayPal buttons. The button language affects only the button, not your shop language. Click Save settings after making changes; unsaved changes are lost when you leave the page.
Set up Apple Pay
Go to Shopware Payments > Settings > Apple Pay. To use Apple Pay, assign your shop domain to an active production account and register it successfully. Apple Pay is not supported in the test account.
In the Account field, select the active merchant account.
- Click Add Domain.
- Enter the domain name without the protocol, for example
example.comorshop.example.com. - Download the
apple-developer-merchantid-domain-associationfile. - Upload the file to your web server at
/.well-known/apple-developer-merchantid-domain-association. - Make sure the file is publicly accessible without authentication or redirects. For Shopware installations, the
publicdirectory is the web root. - Click Register Domain and check that the domain appears as registered.
Example server path: …/public/.well-known/apple-developer-merchantid-domain-association. The corresponding URL is https://example.com/.well-known/apple-developer-merchantid-domain-association.
Manage payments in orders
Open an order in the Administration and select the Shopware Payments tab. There you can view payment information and access manual actions, depending on the payment intent and transaction status.
Payment information and history
The order view may display payer information, payer ID, invoice amount, shipping costs, total amount, payment intent, and transaction creation and update times. Payment history includes each transaction’s type, ID, amount, status, fees, and timestamps.
Payment intent and actions
| Term/action | Requirement | Effect |
|---|---|---|
| AUTHORIZE | Payment has been authorized. | The amount is reserved; it can be captured later or the authorization can be voided. |
| CAPTURE | Payment has been captured. | The customer has been charged. |
| Capture | Authorized payment. | Charge the reserved amount to complete the payment. |
| Void authorization | Existing authorization. | Release the reserved amount without charging the customer. |
| Refund | Payment has already been captured. | Issue a refund through Shopware Payments; the transaction status is updated. |
Transaction status
The Created status indicates a successful authorization. Completed means the payment has been captured successfully. Other statuses may appear depending on the payment method and processing stage.
Automate payment processes with the Flow Builder
Capture Payment
The Capture Payment flow action captures a previously authorized payment. It is available for payments with the AUTHORIZE payment intent. For example, you can trigger it when an order is shipped or reaches a specific order status.
Release Funds
Before using this action: The result depends on the current payment status and collection method. For an authorized payment, the authorization is voided. For a captured payment, a full refund is issued.
Use this action for automated cancellations or refund workflows. Configure the flow so the payment status and resulting action match your business process.
Migrate from the classic PayPal integration
Plan the migration carefully to avoid duplicate payment methods at checkout and to keep managing existing orders.
Check that your Shopware Payments account includes all methods currently offered in your shop and that they are ready to use.
- Activate and configure Shopware Payments.
- Initially, deactivate the new Shopware Payments methods.
- Assign them to the required sales channels, matching the assignments of your existing payment methods where possible.
- Test checkout, payment processing, order creation, and order processing.
- Enable the Shopware Payments methods for production and deactivate the corresponding methods in the PayPal plugin at the same time to prevent duplicate entries.
- Keep the existing PayPal plugin installed and active while you may still need to process refunds, customer inquiries, or other actions for existing orders.
- Deactivate or uninstall the old plugin only after all open transactions are complete and no further actions for existing orders are expected.
Before switching, check that: the required payment methods are available; sales channel assignments are correct; a test order succeeds; checkout has no duplicate payment methods; and responsibility for existing orders is clear.
Troubleshooting
Payment status is not updated
- Check whether your shop is publicly accessible.
- Check whether the Shop API is accessible without restrictions.
- Check for maintenance, network issues, firewall rules, or other access restrictions.
- Once your shop is accessible again, check the payment status. Pending status updates are often processed automatically.
If your shop is temporarily unavailable, payment statuses may not update, transactions may not synchronize completely, and payment actions may be delayed. If the issue persists, contact Shopware Support and provide your Shopware version, the affected order or transaction ID, and when the issue occurred.
Payment method is unavailable
- Check the payment method status and provide any missing information.
- Check the merchant and customer countries, currency, and account approvals.
- Make sure the correct account is assigned to the sales channel.
- Check whether the method is enabled and any review has been completed.
Frequently asked questions
What changes and what stays the same?
What stays the same:
PayPal remains your payment service provider
Your existing payment infrastructure remains in place
Compliance responsibilities remain clearly defined
You continue to use your existing PayPal Business account
What improves:
Payments are consolidated in a central payment layer within Shopware. This can simplify operational processes and make workflows more efficient.
A new commercial model and competitive pricing can improve your business economics without requiring fundamental changes to your existing setup or established processes.
Result:
The result is a clearer, more manageable payment system that lets you keep your existing processes running.
Who should I contact for Shopware Payments support?
Shopware is your first point of contact for support. If necessary, Shopware will coordinate with PayPal through established escalation channels.
All plans, from the Community Edition to Shopware Beyond, include Shopware Payments support from Shopware. Support covers onboarding, configuration, operational questions, and troubleshooting.
For payment-specific topics such as compliance, funds management, or transaction processing, Shopware has defined escalation processes with PayPal.
The basic support model is consistent across Shopware plans. Shopware Payments does not have a separate support structure. Response times and service levels follow your Shopware plan. For more information, see the pricing overview.
For Community Edition merchants, the SLA response time is five business days during regular support hours (Monday to Friday, 09:00–17:00 CET, excluding public holidays in North Rhine-Westphalia).