White Label Integration

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:

  1. 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
  2. Technical Setup

    • Receive your API credentials
    • Set up your development environment
    • Choose your integration method
    • Configure webhook endpoints (if using async flow)
  3. Branding Guidelines

    • Provide your brand assets
    • Define your color scheme
    • Specify your logo and visual elements
    • Review and approve the integration design
  4. Testing

    • Access our staging environment
    • Test the integration thoroughly
    • Verify all user flows
    • Validate policy creation and management
  5. 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

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

  1. Review the API Integration Guide for technical details
  2. Contact our partnership team to begin the integration process
  3. Set up your development environment
  4. Start with our sandbox environment for testing

For any questions or assistance, please contact our support team at [email protected].