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:

1. Partner send request to create a new policy into Qoala system.
2. Qoala will take time to create the policy, in the meantime partner system will wait the process (blocking call)
3. Qoala responds the policy details, including policy number, and policy's certificate link.
4. Qoala forward the policy issuance request to insurer system (if any)
5. Qoala record the policy identifier from insurer into qoala system.

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:

1. Partner send request to create a new policy into Qoala system.
2. Qoala response the request with quotation number as acknowledgement instantly
3. Qoala process the policy in the background (not blocking call)
4. Qoala send the policy details, including policy number, and policy's certificate link.
5. Qoala will forward the policy issuance request to insurer system (if any)
6. Qoala will record the policy identifier from insurer into qoala system.