Shopware 6 BlueSnap Payment Integration

 

BlueSnap is a global payment orchestration platform that delivers secure, multi-method payment processing directly within your Shopware 6 store. With the BlueSnap Shopware 6 plugin (built by solution25), merchants can accept credit and debit cards, digital wallets (Apple Pay, Google Pay), and local payment methods in one integration. This all-in-one solution includes built-in fraud protection (3D Secure and Kount risk management) and real-time order updates, so you can offer a fast, secure checkout experience without heavy lifting. As an official Shopware partner, BlueSnap brings key features like hosted payment links, vaulted shopper (tokenization) storage, and support for mobile wallets straight into Shopware’s admin.

BlueSnap’s platform is engineered for global e-commerce: it supports transactions in 100+ currencies across 180+ countries, using a network of local acquiring banks to maximize authorization rates. With one BlueSnap account you can reach customers worldwide without needing multiple merchant accounts. Despite its advanced capabilities, the Shopware plugin is easy for non-technical store owners to use. It installs in minutes from the Shopware marketplace, and setup is done via simple fields in the administration panel. Developers also have full control: the plugin is open-source on GitHub, and BlueSnap provides APIs and webhooks for custom workflows. In short, BlueSnap makes payments fast, secure, and straightforward for your Shopware 6 store.

Key Features & Benefits

• • • Fast, Secure Checkout – BlueSnap’s hosted checkout (Payment Link) delivers a responsive, PCI-compliant payment page optimized for desktop and mobile devices. Because the BlueSnap hosted page handles all payment data, your PCI burden is minimal (SAQ-A level). Transactions are protected by industry-standard security and optional 3D Secure authentication, reducing fraud and chargebacks.
    • Multiple Payment Methods – Accept a wide range of payment types: credit/debit cards (Visa, MasterCard, Amex, etc.), digital wallets (Apple Pay, Google Pay, Click to Pay), and local methods like ACH/ECP and BECS Direct Debit. BlueSnap even supports PayPal and many other wallets through its platform. This flexibility means your customers have more ways to pay, improving conversion.

  

  • Built-in Fraud Protection – BlueSnap integrates real-time fraud tools (including a partnership with Kount) to automatically screen transactions. Enabling 3D Secure further authenticates cardholders and blocks unauthorized charges. These features are managed via simple checkboxes in the plugin settings.
  • Vaulted Shopper (Tokenization) – Let customers securely save their cards on file for future purchases. The BlueSnap plugin offers “vaulted shopper” functionality so shoppers can update or delete stored cards in their account. Stored payment tokens speed up repeat checkout and support recurring orders (subscriptions).
  • Instant Order Sync – Payment statuses (authorized, captured, refunded, chargeback, etc.) sync automatically between BlueSnap and Shopware. Order details and transaction IDs update in real time, so you can manage orders directly in the Shopware admin without manual reconciliation. Webhooks (e.g. CHARGE and CHARGEBACK events) drive these updates behind the scenes.
  • Global Multi-Currency Support – Process sales in 100+ currencies and settle funds in your chosen currency. BlueSnap’s intelligent payment routing uses local acquiring banks worldwide to boost approval rates, even on cross-border transactions. This means higher international sales for your Shopware store.
  • User-Friendly Admin – Manage all BlueSnap settings from within Shopware 6’s familiar admin interface. The plugin includes a guided setup page for API credentials, and payment methods are enabled per Sales Channel with just a few clicks. Even non-technical users can handle everything through the dashboard.
  • Developer-Friendly – For technical users, BlueSnap offers extensive APIs, SDKs, and documentation. The plugin code (by solution25) is open source on GitHub for custom tweaks. BlueSnap provides a full-featured REST API and hosted fields/checkout options if you need deeper integration. Detailed developer docs and a sandbox environment let you test every scenario.

Installation & Configuration

Follow these steps to set up BlueSnap on your Shopware 6 store:

Install the BlueSnap Plugin: Download and install the BlueSnap plugin from the Shopware Community Store, or clone it from GitHub into your custom/plugins directory. For example:

cd custom/plugins

git clone https://github.com/solution25com/bluesnap-payment-shopware-6-solution25.git

• • • • Then clear the cache and rebuild the plugin list (bin/console plugin:refresh) You should see “BlueSnap” in the Extensions > My extensions list.
      • Activate the Plugin: In your Shopware 6 Admin, navigate to Extensions > My Extensions, find the BlueSnap plugin and click Install, then toggle the switch to activate it. A blue (on) switch indicates the plugin is active.
      • Enter BlueSnap API Credentials: Open the plugin’s settings under Settings > System > Plugins (click the ellipsis … or the plugin name). In the General tab, select your environment (Sandbox or Live) and enter:
      • API Key Live and API Password Live (from your BlueSnap production account)
      • Merchant ID (MID) for your BlueSnap account
      • API Key Sandbox and API Password Sandbox (from your BlueSnap sandbox account).
      • Be sure to copy these values exactly from your BlueSnap account. Sandbox credentials allow you to process test transactions without real money. See Screenshot: BlueSnap Plugin Settings showing where to paste these keys.
      • Enable 3D Secure & Vaulting: In the plugin settings, check the 3DS box to turn on 3D Secure for credit card payments. (Note: you must first enable 3D Secure in your BlueSnap account settings.)
        Also check Save Card under Vaulted Shopper to allow customers to save cards on file. Click Save to apply.
      • Assign Payment Methods: Go to Settings > Shop > Payment Methods, and make sure the “BlueSnap” payment method is enabled and assigned to the correct sales channels. Configure the display name and description as desired. BlueSnap can be set as the default credit card option if preferred. See Screenshot: Shopware Payment Methods for an example setup.

    

    • Test and Go Live: Perform test transactions in Sandbox mode to confirm everything works (use sample card numbers from BlueSnap’s documentation). Once ready, switch the plugin Mode to Live and try a real transaction. Always test in sandbox first to ensure the checkout flow, refunds, and webhooks are operating correctly.
    • Whitelist Shopware IPs (if needed): If your server restricts incoming connections, allow BlueSnap’s integration IP range (185.137.156.32–39) so that transaction updates can be delivered. This ensures Shopware can communicate with BlueSnap’s APIs and webhooks.

By following these steps, you’ll have BlueSnap fully integrated into your Shopware 6 store. The plugin automatically adds “BlueSnap” as a payment option at checkout, and it handles the redirection to BlueSnap’s secure payment page seamlessly.

Easy Administration and Usage

Once installed, BlueSnap’s Shopware plugin is designed for ease of use. In the Shopware admin, you can manage all BlueSnap payments just like any other order:

• • • Customer Checkout: At your store’s checkout page, customers will see BlueSnap alongside other payment options. When selected, they are redirected to a secure BlueSnap-hosted page to enter payment details. The page is optimized for mobile and desktop, ensuring a smooth user experience.
      
    • Saved Payment Methods: If you enabled the Save Card feature, logged-in customers can choose to store their credit card for future orders. They can later manage or delete these saved cards from their account area, adding convenience and transparency to recurring billing.
    • Order Management: After payment, the order status in Shopware is automatically updated (e.g. “Paid” or “Refunded”) based on BlueSnap’s response. You can view transaction details (authorization ID, refund amounts, chargebacks, etc.) directly in the order edit screen. Instant syncing of payment status keeps your backend data accurate without manual checks.
    • Reporting & Dashboard: BlueSnap transactions also appear in your Shopware sales reports. Use Shopware’s reporting tools to filter sales by payment type (BlueSnap) or check on revenues in different currencies. BlueSnap’s own Merchant Portal provides advanced analytics and settlement information if you need deeper insights.

Overall, no specialized training is required – store owners and staff can handle BlueSnap payments through the familiar Shopware interface. If needed, you can always refer to the BlueSnap Merchant Portal for more detailed transaction data and reports.

Developer Resources

For developers, BlueSnap offers a robust toolkit to customize and extend your Shopware integration:

• • • Open-Source Plugin Code: The BlueSnap plugin (by solution25) is open-source on GitHub. You can review or modify the code to fit custom workflows. For example, you could override templates, extend payment method conditions, or integrate the plugin with other Shopware extensions.
    • API & Webhooks: BlueSnap’s RESTful API provides full control over payments, refunds, subscriptions, and more. While the plugin handles the standard flow, developers can use the API for advanced features or third-party integrations. The plugin listens for BlueSnap webhooks such as CHARGE and CHARGEBACK to keep Shopware in sync; you can also handle these events in your own custom code or plugins if needed.
    • Sandbox Testing: BlueSnap provides a sandbox environment for development and QA. Use the sandbox credentials (entered in the plugin) to simulate transactions without real cards. This lets you test things like error handling, 3DS flows, and refunds.
    • Security & Compliance: BlueSnap’s libraries and hosted fields meet high security standards. Developers should ensure SSL is enabled on the Shopware site (BlueSnap requires HTTPS for embedded frames). Avoid logging or exposing API credentials in code – keep them safely stored in the plugin configuration.
    • Language and Platform Support: BlueSnap’s services and the plugin support multi-language deployments (Shopware can present the payment page in 29 languages). The plugin is compatible with Shopware 6.x on PHP 7.x/8.x (see Shopware’s requirements). For custom themes or storefront changes, the hosted checkout page can be styled via BlueSnap’s page designer if desired.

Refer to the BlueSnap Developer Docs for complete API references, code samples, and integration guides. The combination of the Shopware plugin and BlueSnap APIs gives your development team a flexible foundation to build any advanced payment solution.

Best Practices

To get the most from your BlueSnap-Shopware integration, follow these best practices:

• • • Use Sandbox Testing First: Always use the BlueSnap Sandbox environment for initial tests. Verify that checkout, refunds, and webhooks work as expected before switching to live mode.
    • Enable 3D Secure: Turn on 3D Secure (3DS) in both your BlueSnap account and the Shopware plugin. 3DS adds a layer of authentication (such as SMS codes) for card payments, dramatically reducing fraud.
    • Protect Your API Keys: Keep your BlueSnap API credentials secret. Do not embed them in public code or share them. Rotate keys if you suspect a breach. Only input keys in the secured Shopware admin interface.
    • Communicate Card Storage: If you offer saved card payments (Vaulted Shopper), inform customers that their card may be securely stored. Provide clear links for them to manage or delete stored cards in their account area.
    • Monitor Transactions: Regularly check the BlueSnap Merchant Portal and Shopware order logs for any failed or flagged transactions. Prompt action on disputes or declines can minimize revenue loss.
    • Keep the Plugin Updated: Update the BlueSnap plugin whenever a new version is released. Updates may include security improvements, new features, or compatibility fixes. Staying current ensures smooth operation.

By following these guidelines, you’ll ensure that the Shopware-BlueSnap payment flow is secure, reliable, and optimized for your customers and your business.

BlueSnap vs. Other Payment Gateways

How does BlueSnap stack up against other payment solutions like Stripe or PayPal? Here are a few differentiators:

• • • • Global Reach with One Account: BlueSnap supports 180+ countries and 100+ currencies on a single merchant account. Stripe requires separate regional accounts (e.g. one for the US, one for the EU) to sell internationally. This makes BlueSnap simpler for a global Shopware store – you integrate once and accept payments worldwide.
      • Broad Payment Options: In addition to all major credit cards, BlueSnap natively includes many popular payment types. For example, it supports PayPal, Amazon Pay, Masterpass, Skrill, and Alipay, as well as Apple Pay and Google Pay. Stripe also supports most of these, but some via third-party setups. PayPal (the platform) primarily offers its own wallet checkout. BlueSnap’s advantage is having one platform that covers all these methods together, so customers can choose whatever works for them.

    

    

    • Fraud & Chargeback Tools: BlueSnap integrates advanced fraud prevention (including 3D Secure and Kount) and offers dispute management services. Stripe and PayPal have their own fraud tools (Stripe Radar, PayPal Seller Protection), but BlueSnap emphasizes enterprise-level fraud controls and a dedicated chargeback management partnership. Many merchants find BlueSnap’s full-stack approach to fraud reduction reduces losses from chargebacks.
    • Hosted Checkout & PCI Scope: BlueSnap’s Shopware plugin uses a hosted payment link, meaning customers pay on a BlueSnap page. This offloads PCI compliance (you remain at SAQ-A), which is simpler than a fully self-hosted form. Stripe also offers a hosted Checkout solution, while PayPal’s standard integration similarly handles PCI on their side. In Shopware 6, BlueSnap’s plugin balances convenience and security by hosting the sensitive payment fields externally.
    • Integration for Shopware: Unlike generic APIs, BlueSnap’s integration was built specifically for Shopware 6 (by a Shopware Silver partner). This ensures smoother compatibility and support. If your store already uses PayPal or Stripe, you can still add BlueSnap to give customers more choices, all within one cohesive system.

In summary, BlueSnap’s edge is global flexibility and built-in risk management in one solution. It complements (or can replace) gateways like Stripe and PayPal by adding more payment types and advanced tools without fragmenting your operations.

Frequently Asked Questions

• Q: Do I need a BlueSnap account to use this plugin?
  Yes. BlueSnap is the payment processor behind the scenes. You must register for a BlueSnap merchant account (live and sandbox) to get your API credentials (Key, Password, Merchant ID) and use the plugin.
• Q: What payment methods can I accept?
  BlueSnap for Shopware handles all major credit and debit cards, digital wallets (Apple Pay, Google Pay, Click-to-Pay), and many direct debit options (ACH, SEPA, etc.) as well as PayPal and other e-wallets through BlueSnap. The exact options available depend on your BlueSnap account configuration.
• Q: Is the BlueSnap Shopware plugin easy to install?
  Yes. You can install it from the Shopware Community Store with one click, or clone it via Composer/Git. No coding is required; setup is done through the Shopware admin interface (Settings > Plugins). The step-by-step process is outlined above.
• Q: How do I get my BlueSnap API credentials?
  Log in to your BlueSnap account (or sandbox) and go to API Settings. There you can create or copy your API Key, API Password, and find your Merchant ID (MID). Use those values in the plugin configuration.
• Q: What versions of Shopware are supported?
  The plugin is compatible with Shopware 6 (including 6.4 and 6.5). It leverages Shopware’s plugin system and system requirements. Make sure your Shopware installation meets the official Shopware 6 requirements.
• Q: Are payments processed securely?
  Absolutely. BlueSnap is fully PCI DSS compliant. Customer card data is collected on BlueSnap’s secure, encrypted checkout page, not on your server. You can also enable 3D Secure for extra security. BlueSnap has PCI-validated data centers and adheres to strict security standards.
• Q: Can I process refunds and chargebacks?
  Yes. You can issue refunds either from the Shopware order screen or from the BlueSnap Merchant Portal. The status will sync back to Shopware. For chargebacks, BlueSnap will notify you via webhook and the dispute details can be handled through their portal.
• Q: Does BlueSnap support recurring billing/subscriptions?
  BlueSnap’s platform supports subscriptions and recurring payments (using saved cards or PayPal) if you use their subscription API or AR Automation. The Shopware plugin itself focuses on one-time payments, but stored payment tokens can be used for custom subscription logic via the API.

Troubleshooting Tips

• • • Plugin Not Showing Up:Ensure you placed the plugin folder in custom/plugins and ran bin/console plugin:refresh. Clear caches and check Extensions > My Extensions.
    • Invalid Credentials: Double-check your API Key, Password, and Merchant ID. Make sure you are using the correct credentials for the chosen Mode (Sandbox vs Live).
    • 3D Secure Errors: If you see 3DS failures, ensure you have activated 3DS in your BlueSnap account first; otherwise the plugin’s 3DS setting won’t work.
    • Payment Declined: Check the decline reason returned by BlueSnap (insufficient funds, AVS mismatch, etc.). Also verify the currency and country codes – they must match what’s allowed in your BlueSnap account.
    • Webhook or Notification Issues: If order statuses are not updating, confirm the BlueSnap callback/webhook URLs in your BlueSnap account are correct and reachable. Also verify that your Shopware site is accessible over HTTPS.
    • Styling or Layout Problems: The BlueSnap hosted page can be customized via your BlueSnap portal. In Shopware, if the payment page frame looks odd, ensure your theme supports the plugin and there are no JS conflicts.
    • Error Messages: Check the Shopware logs (var/logs/) and the BlueSnap Merchant Portal’s API logs for any error messages. These can provide clues (e.g. a bad request or authentication issue).

If issues persist, consult the BlueSnap documentation or contact BlueSnap/solution25 support for help.

Get Started Today

BlueSnap’s Shopware 6 integration is a powerful way to add secure, flexible payments to your e-commerce store. With support for multiple payment methods, advanced fraud protection, and a user-friendly setup, you can improve checkout conversions and customer trust. Ready to take your Shopware payments to the next level? Download the BlueSnap plugin from the Shopware store and configure your account today. For more information, visit the BlueSnap website or contact our team to get started.