Qoala Policy Creation API (Asynchronous Flow)

Qoala provides an API for policy creation using an asynchronous (async) flow.
This allows partners to initiate a policy creation request without waiting for the entire process to complete.

📘 Overview

In this integration, the partner system sends a policy creation request to the Qoala API.
Qoala immediately acknowledges receipt of the request and responds with an acknowledgement identifier (quotation number).

Once the policy has been successfully created in the Qoala system, Qoala will send the final policy details to the partner via a callback (webhook) endpoint provided by the partner.

🧩 Architecture Diagram

Qoala manages all connections with insurer systems separately.
This ensures that any insurer-related processing does not affect the communication between the partner and Qoala systems.

🔄 Flow Description

1. Partner → Qoala
   Partner sends a request to create a new policy via the Qoala API.

2. Qoala → Partner
   Qoala immediately responds with a quotation number as an acknowledgement identifier.

3. Qoala (Background Process)
   Qoala processes the policy creation asynchronously (non-blocking).

4. Qoala → Partner Webhook
   Once the policy creation is completed, Qoala sends the full policy details to the partner’s callback API.

5. Qoala → Insurer (If Applicable)
   Qoala forwards the policy issuance request to the insurer’s system, if required.

6. Qoala System Record
   Qoala records the insurer’s policy identifier internally for tracking and future reference.

⚙️ Notes

• Partners must implement a callback (webhook) endpoint to receive the policy creation result.
• Qoala’s acknowledgment response only confirms receipt of the request, not the completion of the policy creation.
• All insurer communication is handled internally by Qoala to simplify the partner’s integration.