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 Embedded Methods

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

Environment & Hostname

Environment	Hostname
Staging	<https://customer.dev.qoala.app>
Pre Production	<https://customer.uat.qoala.app>
Production	<https://customer.qoala.app>

Authentication

Qoala will share 2 different keys for this integration process:

The public key will be used to access the web view URL as public-id this static key will be used by Qoala to validate the partner and define the partner. If the public-id is invalid partner will not be able to access the page.
The Secret key will be used by the partner to encrypt the mandatory data thus used as token and will be decrypted by qoala to get the mandatory data.

Encryption Detail

To access Qoala App web-view the partner needs to follow this specific Requirement.

Method: AES Encryption
Mode: CBC
Key Size in Bits: 128
Text Format: Hex

To encrypt the data partner will use the secret key which will be validated by Qoala’s system.

Embedded Pages

The following part will list down qoala pages that can be embedded into your platform.

1. 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.

Example:

https://customer.dev.qoala.app/policy/external/28812dad34764283655537c182c9912861a0b771ecaf14afff2616edfcba541148eb2a01f466af380cad8a5f6071c4a7477053a56942784cfa0848837af0374810b51d471401cab4a42a7cb3aa2a3cf4988c5211df078b3e8fa430846ae590081749c5e9687047fb8379560aaceefb046090dcb67f886d8e939cbe651ecdc8814d28055c4f5e54c6cd526c5f30b6adbb?public-id=qoxw1hx4ml9ilbt1t5n9je9tbttzef5g

Example Page:

2. Policy Detail

Partners can access a certain of policy detail page.

Endpoint

GET: {{hostname}}/policy/detail-external/:token?public-id={public-key}

Example Link:

https://customer.dev.qoala.app/policy/detail-external/28812dad34764283655537c182c9912861a0b771ecaf14afff2616edfcba541148eb2a01f466af380cad8a5f6071c4a7477053a56942784cfa0848837af0374810b51d471401cab4a42a7cb3aa2a3cf4988c5211df078b3e8fa430846ae590081749c5e9687047fb8379560aaceefb046090dcb67f886d8e939cbe651ecdc8814d28055c4f5e54c6cd526c5f30b6adbb?public-id=qoxw1hx4ml9ilbt1t5n9je9tbttzef5g

3. Claim Form 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.

Example:

https://customer.dev.qoala.app/add-claim/external/28812dad34764283655537c182c9912861a0b771ecaf14afff2616edfcba541148eb2a01f466af380cad8a5f6071c4a7477053a56942784cfa0848837af0374810b51d471401cab4a42a7cb3aa2a3cf4988c5211df078b3e8fa430846ae590081749c5e9687047fb8379560aaceefb046090dcb67f886d8e939cbe651ecdc8814d28055c4f5e54c6cd526c5f30b6adbb?public-id=qoxw1hx4ml9ilbt1t5n9je9tbttzef5g

4. 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.

Example:

https://customer.dev.qoala.app/claim/external/28812dad34764283655537c182c9912861a0b771ecaf14afff2616edfcba541148eb2a01f466af380cad8a5f6071c4a7477053a56942784cfa0848837af0374810b51d471401cab4a42a7cb3aa2a3cf4988c5211df078b3e8fa430846ae590081749c5e9687047fb8379560aaceefb046090dcb67f886d8e939cbe651ecdc8814d28055c4f5e54c6cd526c5f30b6adbb?public-id=qoxw1hx4ml9ilbt1t5n9je9tbttzef5g

Example Page:

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].