Payment Notifications

This endpoint is used to notify Casava when the policyholder has completed their payment.

Used to notify casava of completed payment from a policy holder via the channel

post

Authorizations

Header parameters

api_keyanyrequired

Body

paymentReferencestringrequired

unique payment reference from the channel used to identify policy holder payment

Example: ref123

policyHolderNumberstringoptional

policy holder system generated unique identifier

Example: 12345678

amountnumberrequired

payment amount

Example: 50

currencystringoptional

payment amount currency

Example: NGN

paymentDatestringoptional

transaction payment date

Example: 2021-10-23

paymentEffectiveDatestringoptional

settlement payment date for reconcillation purpose

Example: 2021-10-23

paymentChannelstringoptional

channel used to complete payment

Example: MOBILE

policyNumberstringoptional

unique reference used to identify a policy with a policy holder

Example: 12345623

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://channel.sandbox.casava.co/api/channel-service/v1/paymentNotifications' \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "paymentReference": "ref123",
    "policyHolderNumber": "12345678",
    "amount": 50,
    "currency": "NGN",
    "paymentDate": "2021-10-23",
    "paymentEffectiveDate": "2021-10-23",
    "paymentChannel": "MOBILE",
    "policyNumber": "12345623"
  }'

200

400

200

{
  "paymentReference": "ref123",
  "processingReference": "ref123",
  "policyHolderNumber": "12345678",
  "amount": 50,
  "status": "success"
}

successful operation

Sample Request

{
  "paymentReference": "ref123",
  "policyHolderNumber": "080292929215",
  "amount": 50,
  "currency": "NGN",
  "paymentDate": "2021-10-23",
  "paymentEffectiveDate": "2021-10-23",
  "paymentChannel": "MOBILE",
  "policyNumber": "12222070620220118800055"
}

Sample Response

{
  "statusCode": 200,
  "message": "successful operation",
  "data": {
    "paymentReference": "ref123",
    "policyHolderNumber": "080209934213519",
    "amount": 50,
    "status": "pending",
    "processingReference": "ref123"
  }
}