This page describes how to integrate Qoala's insurance products as a white label solution in your platform.
White Label Integration Guide
Welcome to Qoala's White Label Integration Guide! This documentation will help you understand how to integrate Qoala's insurance products into your platform while maintaining your brand identity.
Overview
White label integration allows you to offer Qoala's insurance products under your brand name, providing a seamless experience for your customers while leveraging our robust insurance infrastructure. This integration method enables you to:
- Maintain your brand identity throughout the customer journey
- Offer insurance products without building the infrastructure from scratch
- Provide a seamless user experience within your platform
- Access Qoala's comprehensive insurance product portfolio
Integration Methods
Qoala offers two primary methods for white label integration:
1. API Integration
The API integration method allows you to build a custom user interface while leveraging Qoala's backend services. This method provides the most flexibility in terms of user experience and branding.
Key features:
- Complete control over the user interface
- Customizable user flows
- Direct integration with your existing systems
- Real-time policy creation and management
For detailed API documentation, refer to our API Integration Guide.
2. Embedded Solution
The embedded solution provides a pre-built, customizable interface that can be seamlessly integrated into your platform. This method offers a faster time-to-market while maintaining brand consistency.
Key features:
- Quick integration with minimal development effort
- Consistent user experience across platforms
- Customizable branding and styling
- Responsive design for all devices
Getting Started
To begin your white label integration journey, follow these steps:
-
Contact Qoala Partnership Team
- Reach out to our partnership team to discuss your integration needs
- Define your requirements and expected volume
- Review available insurance products
-
Technical Setup
- Receive your API credentials
- Set up your development environment
- Choose your integration method
- Configure webhook endpoints (if using async flow)
-
Branding Guidelines
- Provide your brand assets
- Define your color scheme
- Specify your logo and visual elements
- Review and approve the integration design
-
Testing
- Access our staging environment
- Test the integration thoroughly
- Verify all user flows
- Validate policy creation and management
-
Go Live
- Complete final review
- Switch to production environment
- Monitor initial transactions
- Gather user feedback
Customization Options
Branding Elements
You can customize the following elements to match your brand:
- Color scheme
- Typography
- Logo placement
- Button styles
- Form elements
User Interface Components
Available for customization:
- Policy details view
- Policy list view
- Claim submission form
- Claim list
- Claim detail
Claim Integration
This section details the specific API endpoints and integration process for white-label partners to handle claim submissions and access policy information.
Environment Hostnames
Environment | Hostname |
---|---|
Staging | https://claim.dev.qoala.app |
Production | https://enterprise-claims.qoala.app |
1. Claim Submission
Partners can initiate the claim submission process for their users using the following endpoint.
Endpoint
GET {{hostname}}/id/add-claim/external/:token?public-id={public-key}
Parameters
:token
: An encrypted data string generated by the partner using a secret key provided by Qoala. The encrypted value must include the following information in JSON format:
{
"policyNumber": "POLICY_NUMBER",
"phoneNumber": "+628123456789",
"bookingId": "1031880607"
}
public-id
: A random alphanumeric string generated by Qoala.
2. Claim List
Partners can retrieve a list of claims associated with their users.
Endpoint
GET {{hostname}}/id/claim/external/:token?public-id={public-key}
Parameters
:token
: An encrypted data string containing the following information:
{
"phoneNumber": "+628123456789"
}
public-id
: A random alphanumeric string generated by Qoala.
3. Policy List
Partners can access a list of policies associated with their users.
Endpoint
GET {{hostname}}/id/policy/external/:token?public-id={public-key}
Parameters
:token
: An encrypted data string containing the following information:
{
"phoneNumber": "+628123456789"
}
public-id
: A random alphanumeric string generated by Qoala.
Next Steps
- Review the API Integration Guide for technical details
- Contact our partnership team to begin the integration process
- Set up your development environment
- Start with our sandbox environment for testing
For any questions or assistance, please contact our support team at [email protected].