Skip to content

Instant issue and pay motor policy

POST
/policies/motor/instant/issue/pay

Create, issue, and initiate payment for a motor policy in a single step.

Payment options:

  • Mobile money: set payment.mobileMoneyAccountNumber
  • Card: set payment.cardDetails — response includes redirectUrl to complete 3DS

The reference field is your unique transaction reference for reconciliation.

Authorizations

BearerAuth
Type
HTTP (bearer)

Request Body

application/json
JSON
{
  
"productId": "qkVe0kJo",
  
"duration": 0,
  
"currency": "ZMW",
  
"startDate": "string",
  
"policyHolder": {
  
  
"type": "Individual",
  
  
"name": "John Banda",
  
  
"phone": "260971234567",
  
  
"email": "string",
  
  
"physicalAddress": "string",
  
  
"idType": "string",
  
  
"idNumber": "string",
  
  
"tpinNumber": "string"
  
},
  
"risks": [
  
  
{
  
  
  
"make": "Toyota",
  
  
  
"model": "Hilux",
  
  
  
"yearOfManufacture": 2022,
  
  
  
"capacity": 1955,
  
  
  
"tonnage": 0,
  
  
  
"seatingCapacity": 5,
  
  
  
"photosUrls": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"registrationNumber": "ABC1234",
  
  
  
"chassisNumber": "string",
  
  
  
"engineNumber": "string",
  
  
  
"sumInsured": 100000,
  
  
  
"currency": "ZMW",
  
  
  
"color": "string",
  
  
  
"motorRiskCategoryId": "RWMmOVm9",
  
  
  
"motorBodyTypeId": "string"
  
  
}
  
],
  
"reference": "PARTNER-REF-001",
  
"payment": {
  
  
"method": "string",
  
  
"mobileMoneyAccountNumber": "0971234567",
  
  
"cardDetails": {
  
  
  
"city": "string",
  
  
  
"country": "string",
  
  
  
"address": "string",
  
  
  
"zip": 0
  
  
},
  
  
"gateway": "Airtel"
  
}
}

Responses

Motor policy issued and paid

application/json
JSON
{
}

Playground

Authorization
Body

Samples

Built with ❤️ by Hobbiton Technologies