Integration & Embedding

How to Embed Your Self-Service Portal

Our self-service portal solution offers flexible deployment options to seamlessly integrate with your existing digital presence. This guide explains the available methods for embedding the portal into your webshop or website.

Available Embedding Options

You can implement the self-service portal in three primary ways:

Stand-Alone Implementation

The stand-alone option deploys the portal as an independent web application, complete with its own header and footer. This is ideal when you want to:

• Provide a dedicated returns and service experience
• Maintain a consistent self-service portal appearance across all touchpoints
• Deploy quickly without modifying your existing website

Implementation Steps

1. Use the provided portal URL directly in your communications
2. Link to the portal from your main website navigation or footer
3. Include the portal link in order confirmation emails and account pages

iFrame Integration

The iFrame option embeds the portal directly within your existing website or webshop. This creates a seamless experience where customers can access self-service features without leaving your branded environment.

Implementation

For implementing the iFrame integration, please refer to the "Integration Helper" section within your self-service portal configuration. This tool provides:

• Ready-to-use code snippets specifically configured for your portal
• Responsive implementation options that adapt to different viewport sizes
• Advanced settings including header/footer visibility and scroll-to-top functionality

The Integration Helper generates all necessary code tailored to your specific portal instance. Simply copy the provided code and paste it into your website where you want the portal to appear.

Security Requirements

Important: To ensure secure data handling and prevent CORS (Cross-Origin Resource Sharing) issues, your domain must be whitelisted before implementing the iFrame integration. This security measure protects both your data and your customers' information by only allowing authorized domains to embed the portal.

You can whitelist your domains directly in the "Integration Helper" section:

• Navigate to the Integration Helper in your portal configuration
• Add the exact domain(s) where you plan to embed the portal
• Save your changes

The whitelisting will take effect immediately, allowing you to implement the iFrame integration right away. Without proper domain whitelisting, the iFrame integration will not function correctly and may result in security errors or blocked content.

Native Integration with Business Systems

For users of supported business systems like Salesforce and Zendesk, our standard integrations provide native embedding capabilities that seamlessly incorporate the portal directly into these environments.

Implementation

For system-specific integration instructions, please refer to the documentation for each specific integration. These integrations allow you to embed the self-service portal directly within your business system's interface without requiring manual code implementation.