Initiate Policy Renewal Payment
POST
/credit-life/policies/{policyId}/renew/pay
Authorizations
BearerAuth
Type
HTTP (bearer)
Parameters
Path Parameters
policyId*
Type
Requiredstring
Request Body
application/json
JSON "reference": "string", "mobileMoneyAccountNumber": "string", "cardDetails": { "city": "string", "country": "string", "address": "string", "zip": 0 }
{
}
Responses
Opens the current cover period and pays for it in one call — same request/response shape as schedules/{scheduleId}/pay. Only settles one outstanding period at a time; a policy with arrears spanning more than one period rejects this call, and each period is paid individually via schedules/{scheduleId}/pay instead. Poll GET /payments/transactions/{reference}/status — the premium is receipted, and the period incepted, once the gateway confirms.
application/json
JSON "payment": { "status": "string", "message": "string", "txnId": "string", "referenceId": "string", "redirectUrl": "string", "warnings": [ "string" ] }, "coverState": { "status": "string", "currentPeriodIndex": 0, "currentPeriodStart": "string", "currentPeriodEnd": "string", "graceEndsAt": "string", "unpaidPeriods": [ 0 ], "premiumPerPeriod": 0, "totalCoveredAmount": 0, "aggregateClaimLimit": 0, "uncoveredAmount": 0 }
{
}