Keke Policy
Initiate Keke Policy
This endpoint initiates the creation of a keke insurance policy.
POST
https://sandbox.insurpass.com/api/merchant/initiate_keke_pass_policy
This method initiates the creation of a keke insurance policy, it returns a token which must then be verified before the policy can be created successfully.
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | {$secret-key}/{$api-key} |
Content-Type* | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
first_name* | String | Principal customer's first name |
last_name* | String | Principal customer's surname |
phone_number* | numeric|digits:11 | Principal customer's phone number. 09812348459 |
email* | Principal customer's email address email@domain.com | |
gender* | String | Principal customer's gender. female, male |
address* | String | Principal customer's house address |
relationship* | String | |
variant_type* | options | confaam,no-shaking,carry-go,jeje |
amount_insured* | numeric | amont of money insured. 500,000 |
identity* | String | |
nok_surname* | String | Next of kin surname |
nok_othernames* | String | Next of kin other names |
nok_relationship* | String | Relationship with next of kin |
nok_gender* | String | nxt of kin gender - female, male |
nok_phone_no* | numeric|digits:11 | next of kin phone number. 0812345678 |
nok_email_address* | next of kin email address - email@domain.com | |
product_id* | numeric | unique number used to identify keke policy. - 3 |
id_url* | String | image url of id - https://picsum.photos/ |
id_type* | options | nin,voters_card,drivers_license,intl_passport |
id_number* | numeric | id number. |
Verify Keke Policy
This endpoint sends a token that verifies the creation of a keke insurance policy.
POST
https://sandbox.insurpass.com/api/merchant/verify_keke_pass_policy
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Bearer {$secret-key}/{$api-key} |
Content-Type* | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
token* | String | Note that after 15 minutes, the token expires and you will need to reinitiate |
The Initiate token expires in 15 minutes, and if a user does not verify his/her subscription after 15 minutes of initiation, the details of the subscription will be deleted.
List All Keke Policies
This endpoint returns a list of all the keke insurance polices.
GET
https://sandbox.insurpass.com/api/merchant/merchant_keke_pass_policies
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Bearer {$secret-key}/{$api-key} |
Content-Type | String | application/json |
Keke Policy Details
This endpoint returns an object containing a single keke policy
POST
https://sandbox.insurpass.com/api/merchant/keke_policy_details
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Bearer {$secret-key}/{$api-key} |
Content-Type* | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
policy_number* | String | The unique number that identifies the purchased insurance policy - IN98570819 |
Keke Policy Quote
The endpoint return a quote for a keke policy.
POST
https://sandbox.insurpass.com/api/merchant/keke_get_policy_quote
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Bearer {$secret-key}/{$api-key} |
Content-Type* | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
product_id* | numeric |
Last updated