General Insurance
This guide covers issuing general insurance policies using the Inshuwa API.
Every step below is runnable. Set your key once, fill in the request, press Try it out, and read the real response without leaving the page — see Running requests from the guide.
Set it once and every Try it out below is authenticated. It stays in this browser's local storage and is never sent anywhere but the API.
Overview
General insurance covers non-motor, non-life, non-travel products such as property, fire, engineering, and liability insurance.
Choose your issuance flow
General supports three of the four issuance flows.
| Prepaid — Inshuwa collects | Account-settled — PayLater / external | |
|---|---|---|
| Quotation first | A. quotation → POST /payments/{quoteId}/pay | C. quotation → POST /policies/{quoteId}/issue |
| Instant (one call) | — | D. POST /policies/instant/issue |
The general issue endpoints never collect a premium — POST /policies/{quoteId}/issue always settles externally, and POST /policies/instant/issue carries no payment block. For the prepaid path, pay the quotation with POST /payments/{quoteId}/pay, which issues the policy once the payment confirms.
Step 1: Create a Policyholder
Step 2: Select a Product
Flow A: Pay the quotation (prepaid)
Paying issues the policy — there is no separate issue call on this path. The response is Pending until the payer approves; poll the reference and the transaction status returns the issued policy.
/payments/{quoteId}/payPlayground
Authorization
Variables
Body
/payments/transactions/{reference}/statusPlayground
Authorization
Variables
Flow C: Issue a quotation (account-settled)
Issues immediately against your account's external settlement arrangement.
/policies/{quoteId}/issuePlayground
Authorization
Variables
Flow D: Instant issue (account-settled)
Supply the policyholder and risk inline. No payment block — the premium is settled outside the gateway.
Renew a Policy
/policies/{policyId}/renewPlayground
Authorization
Variables
Body
View Policies
Lists all policies across all lines — motor, life, travel and general.