All Topics
BlueSnap.comDeveloper DocsShopper SupportStatusTalk to Sales

Shopware Setup

Shopware’s open-source platform delivers industry-leading innovations and unmatched flexibility, ensuring your business stays future-ready.

Shopware equips you with powerful ecommerce capabilities that excel in both B2C and B2B environments. Whether you’re managing complex transactions, handling vast product catalogs, or navigating long sales cycles, Shopware empowers you to scale your business rapidly and efficiently.

Supported Features

3D Secure
Chargeback Management
Payment Methods: Apple Pay, Google Pay, ACH/ECP, BECS Direct Debit, Credit/Debit Cards
Fraud Prevention:
Built-in Fraud Prevention and Risk Management
Enhanced fraud using Device Data Collector
Multi-Device & Multi-Platform Support – Optimized for web and mobile.
Payment Links
Multiple Currencies
Merchant Transaction ID (MTI) — Add custom metadata to a transaction.
Partner Sandbox Testing
Real-Time Transaction Tracking – View and manage payments instantly.
Vaulted Shoppers
Webhooks

Requirements

You must download Shopware 6 and have a BlueSnap account:

To download Shopware 6, go to the Shopware website.
To create a BlueSnap account, go to the BlueSnap website.

Shopware

Shopware requires the following software and configuration:

BlueSnap

BlueSnap requires the following setup and configuration:

Shopware 6 uses BlueSnap webhooks to notify you about important transaction events when they occur. This integration uses the following BlueSnap webhooks:

  • CHARGE
  • CHARGEBACK

For details about each webhook, see All IPNs Name Reference.

Shopware Setup

The BlueSnap Shopware 6 plugin connects BlueSnap's payment gateway with your Shopware store. The following steps install and configure the plugin:

Step 1: Clone the Repository

The plugin is available in solution25's GitHub repository:

  1. In a terminal, navigate to your Shopware 6 custom plugins directory: 
    cd path/to/custom/plugins
  2. Clone the repository: 
    git clone https://github.com/solution25com/bluesnap-payment-shopware-6-solution25.git

Step 2: Install and Activate the Plugin

After you clone the repository, install the plugin in Shopware:

  1. Log in to your Shopware 6 Administration panel.
  2. Go to Extensions > My extensions.
  3. Locate the BlueSnap plugin in the list, and select Install.
  4. After you install the plugin, toggle the switch to activate it. The plugin is activated when the switch is blue and toggled to the right.

After you activate the plugin, the BlueSnap plugin is listed on Extensions > My extensions with the version and installation date.

Step 3: Configure the Plugin

After you install and activate the plugin, you must add your BlueSnap API credentials to Shopware. In addition, you can configure payment features such as 3D Secure (3DS) and Vaulted Shopper (Tokenization).

📘

Note

You must configure 3DS in BlueSnap before you can activate it in the Shopware 6 plugin.

  1. In Shopware, go to Settings > System > Plugins.
  2. Locate the BlueSnap plugin and select the ellipsis icon (...) or the plugin name to open the settings.
  3. In General Settings, add your BlueSnap API credentials for both the production and sandbox environments. Select the environment from the Mode dropdown and complete these fields:
    • API Key Live — Required for production transactions.
    • API Password Live — Public key that authenticates requests to your BlueSnap production environment.
    • Merchant ID — Your BlueSnap merchant ID (MID).
    • API Key Sandbox — Required to test transactions in the BlueSnap sandbox environment.
    • API Password Sandbox — Public key that authenticates requests to the BlueSnap sandbox environment.
  4. In 3D Secure, select the 3DS checkbox to activate 3D secure for all credit card transactions.
  5. In Vaulted Shopper, select the Save Card checkbox so you can securely store payment information for credit card transactions.
  6. When you finish, select Save in the top-right to complete the configuration.

Features

3DS Authentication

3DS reduces fraud and prevents unauthorized transactions. When 3DS is enabled, shoppers are redirected to their online banking portal to authenticate to their bank and complete the transaction.

For details, see 3D Secure.

Payment Link

Shopware leverages BlueSnap's Payment Link feature to redirect your shoppers to a secure BlueSnap Checkout page to complete their transaction. Because the checkout page is hosted by BlueSnap, this solution keeps your PCI burden at the lowest SAQ-A. BlueSnap Checkout is optimized for every device type.

Cards Management

At checkout, shoppers can select the following options to manage their payment cards:

  • Save — Securely store your shopper's card information for future transactions.
  • Update — Shoppers can modify their stored card information and save.
  • Delete — Remove their stored card information from the system.

Best Practices and Tips

BlueSnap and Shopware recommend these best practices and tips to make sure that your integration is running optimally and securely:

  • Sandbox testing — Before you process transactions in a production environment, always test your payment methods and flows in the sandbox environment.
  • Enable 3D Secure — Improve fraud protection with 3D Secure for all credit card transactions.
  • Secure your API Keys — Never share your API keys publicly. Rotate them regularly, if needed.
  • Inform Customers About Saved Cards — Be transparent about card-saving features. Offer your shoppers easy ways to manage or delete saved cards.
  • Monitor Transactions — Regularly check your Bluesnap Merchant Portal to track transactions and handle any failed payments.
  • Update the plugin — Upgrade to the latest version to ensure compatibility and security improvements.

Updated 2 days ago