Unidy and Shopware Integration

Integrate Unidy with Shopware 6 to transform your e-commerce platform with enterprise-grade identity management. This integration, powered by the Fuexchen Unidy Plugin, enables Single Sign-On (SSO), flexible checkout options, and automated customer data synchronization, combining Shopware's powerful e-commerce capabilities with Unidy's secure and efficient identity infrastructure.

Use Case Scenarios

Scenario 1: Frictionless Checkout Experience

Problem: Customers abandon their shopping carts during the login or registration process, leading to lost revenue.
Solution: The integration provides a Single Sign-On (SSO) experience where customers can log in to your Shopware 6 store using their Unidy credentials.
Benefits:

• Reduced cart abandonment rates
• Faster checkout process
• Improved conversion rates
• Enhanced customer satisfaction

Scenario 2: Flexible Checkout Options for Different Customer Types

Problem: Different customer segments have varying preferences for how they want to checkout (guest, registered account, or SSO).
Solution: With the Unidy Shopware Plugin, you can configure flexible checkout options, allowing customers to order as guests, via a Shopware 6 account, or with Unidy SSO.
Benefits:

• Maximum flexibility for diverse customer preferences
• Optimized conversion for each customer segment
• Reduced friction in the purchase process
• Better user experience customization

Scenario 3: Membership-Based Shopping Privileges

Problem: Managing different customer groups with special pricing, pre-sale access, or exclusive products is complex.
Solution: Synchronize Unidy memberships and user groups with Shopware, automatically granting members access to exclusive products, special discounts, and priority purchasing.
Benefits:

• Automated member benefit management
• Dynamic pricing based on membership status
• Exclusive product access for premium members
• Enhanced member value proposition

Scenario 4: Centralized Address and Customer Data Management

Problem: Customer data and addresses are scattered across multiple systems, leading to inconsistencies and manual update efforts.
Solution: The integration synchronizes customer address data with Unidy, creating consistent user profiles across all platforms and ensuring data accuracy.
Benefits:

• Centralized address management
• Consistent customer data across platforms
• Reduced manual data entry
• Improved data quality and compliance

Key Features

Single Sign-On (SSO)

Customers can log in to your Shopware 6 store using their Unidy credentials, ensuring a seamless and secure authentication process. Eliminate the need for separate e-commerce accounts and reduce checkout friction.

Flexible Checkout Configuration

Decide whether customers can order as guests, via a Shopware 6 account, or with Unidy SSO. Configure the user experience in your shop with just a few checkboxes, defining how customers interact with login and checkout options.

Centralized Address Management

Synchronize customer address data with Unidy for consistent user profiles across all platforms. Updates in one system automatically reflect in the other, ensuring data accuracy.

Membership and User Group Synchronization

Automatically sync Unidy memberships and user groups to Shopware customer groups or custom fields. Enable dynamic pricing, exclusive product access, and targeted marketing based on membership status.

Seamless Integration

The Fuexchen Unidy Plugin makes Shopware 6 a seamless part of your Unidy ecosystem, providing a fully integrated environment for your customers.

Update User Data on Login

Configure whether user data should be updated on each login, ensuring customer information stays current across both systems.

Benefits

For Customers

• Seamless Shopping Experience: Log in once and shop across all your platforms without repeated authentication.
• Faster Checkout: Skip lengthy registration forms or choose to checkout as a guest based on preference.
• Consistent Profile: Profile updates in one place reflect everywhere automatically.
• Flexible Options: Choose the login method that works best for each shopping session.

For Businesses

• Increased Conversion Rates: Reduced friction in the checkout process leads to higher conversion and lower cart abandonment.
• Better Customer Insights: Unified customer data provides comprehensive insights for personalized marketing and product recommendations.
• Operational Efficiency: Centralized customer management reduces administrative overhead and support costs.
• Enhanced Security: Enterprise-grade security protocols protect customer data and build trust.
• Membership Monetization: Easily implement membership-based pricing and exclusive access to drive recurring revenue.
• Fully Integrated Ecosystem: Shopware 6 becomes a seamless part of your broader Unidy environment.

Technical Details

Setup Instructions

1. Install Unidy Shopware Plugin: Download and install the Fuexchen Unidy Plugin from the Shopware Store or receive it from your Customer Success Manager.
2. Request OAuth Credentials: Contact your Unidy Customer Success Management to receive the required OAuth credentials.
3. Configure Plugin Settings: Enter your Unidy instance domain and the provided OAuth credentials in the plugin settings.
4. Configure User Experience: Use the checkboxes in the plugin settings to configure how customers interact with login and checkout options.
5. Test Integration: Perform comprehensive testing including login, registration, checkout, and data synchronization.

Requirements

• Shopware 6 store
• Unidy account with API access
• OAuth credentials (provided by Unidy Customer Success)
• Fuexchen Unidy Plugin (version 1.2.3 or higher recommended for advanced features)

Required OAuth Scopes

• users:read - Read user profile information (required for testing OAuth credentials)
• active_membership (optional) - Access membership and subscription data for group synchronization

APIs and Endpoints

• SSO Login API: Facilitates customer authentication from Shopware 6 using Unidy credentials via OAuth 2.0.
• Registration API: Allows new customers to register on Shopware 6 through Unidy's registration system.
• Customer Data Sync API: Ensures synchronization of customer data including addresses between Unidy and Shopware 6.
• Membership Sync API: Synchronizes Unidy memberships and user groups to Shopware customer groups and custom fields.

Advanced Configuration

Synchronizing User Groups from Unidy to Shopware

Unidy user groups can be synchronized with Shopware and assigned specific rights such as discounts, pre-sale access, or other privileges. This is achieved by creating a custom subscriber that listens to two events:

Available Events:

• UnidyOauthScopes - Extends the requested scopes from Unidy
• UnidyCustomerObjectBuild - Extends the generated customer mapping with additional fields

Example Use Case:
Sync active membership status to Shopware custom fields to enable member-specific pricing or product access.

Note: These events are available starting from version 1.2.3 of the plugin. To apply this approach to existing users, ensure that the plugin settings are configured to update user data on login.

Custom Data Mapping

Beyond standard fields (name, email, address), you can map custom Unidy attributes to Shopware customer custom fields. This allows you to:

• Store membership numbers in Shopware
• Sync custom customer preferences
• Track member-specific data for analytics
• Enable conditional business logic based on Unidy data

Unidy ID in Shopware

The Unidy ID is stored in Shopware but not displayed in the UI. It can be accessed via:

• Database: Separate entity type fuexc_unidy_user
• Code: Association unidyUser on CustomerEntity
• API: Entity name fuexc_unidy_user in API responses

When calling up a customer via Shopware Administration, the Unidy user entity with corresponding data appears in the API response under included.

Logout Synchronization

When activated, logging out from Shopware will also log the customer out from Unidy, ensuring a consistent experience across all integrated platforms.

Setup:
To enable this feature, whitelist your Shopware store's post-logout redirect URI in your Unidy instance under Admin → Settings → Settings → User flow settings.

Contact Us

Have questions or need assistance with your Shopware integration? Contact our support team for personalized help with setup, configuration, and optimization.