This page describe how our partner connect to qoala system through API integration.
Qoala offers two methods for policy creation integration: synchronous (sync) flow and asynchronous (async) flow.
Synchronous Flow Integration
In the synchronous flow method, partners send a request to the Qoala system and wait for the policy to be successfully created. Once the policy creation is complete, the system returns a response for the corresponding request.
Qoala will manage connectivity to insurer system seperately so it will not impact interconnection between partner and Qoala.
Based on diagram above, here is the detail of the flow:
- Partner hits the API to create a new quote along with a new policy into Qoala system.
- Qoala will forward the policy issuance request to insurer system (if any)
- Qoala will record the policy identifier from insurer into qoala system.
- Qoala responds with policy information, including quotation number, policy number, and policy certificate details.
Asynchronous Flow Integration
In the asynchronous flow method, partners send a request to the Qoala system, which immediately acknowledges receipt and returns a response with an acknowledgment identifier. Partners must provide a callback API to receive the policy information once the policy has been successfully created in the Qoala system.
The following diagram show how asynchronous flow integration on policy creation:
Qoala will manage connectivity to insurer system seperately so it will not impact interconnection between partner and Qoala.
Based on diagram above, here is the detail of the flow:
- Partner hits the API to create a new quote along with a new policy in the Qoala system.
- Qoala responds with policy information, including quotation number, policy number, and policy certificate details.
- We can communicate with the insurance system if needed.
- Only if we communicate with insurance, we will obtain the insurance number and include it as part of the policy information.
- Partners can use our activation API to activate policies if necessary.
- Qoala will respond with policy activation details.