Purchase Webhook

Event: purchase.successful

This webhook event is triggered when a client initiates a policy purchase, and the transaction is successfully completed.

{
    "event": "purchase.successful",
    "data": {
      "id": "e431432e-3daa-11ee-be56-0242ac120002",
      "amount": 5000,
      "status": "successful",
      "reference": "BUY-PSKUEVZSSXVJRPQX",
      "customer": {
        "id": "db0c25ae0-3dab-11ee-be56-0242ac120002",
        "first_name": "Jack",
        "last_name": "Olu",
        "email": "[e-mail]",
        "phone": "[phone]",
      },
      "product_id": "280798d6-3dac-11ee-be56-0242ac120002",
      "created_at": "2023-08-18T09:47:22.008Z",
      "updated_at": "2023-08-18T09:47:22.008Z",
      "policy_expiry_date": "2023-09-18T09:47:22.008Z",
    },
}

Webhook Parameters And Description

Here are the webhook parameters and their corresponding descriptions:

Data	Description
data.id	The unique ID generated for the purchase
data.amount	The amount paid for the product
data.status	The status of the transaction which is either successful or failed
data.reference	The unique generated reference code bound to the policy
data.customer.id	The unique ID generated for the customer
data.first_name	The customer's first name
data.last_name	The customer's last name
data.email	The customer's email
data.phone	The customer's phone number
data.product_id	The unique ID of the product purchased
data.created_at	The timestamp indicating when the transaction was created
data.updated_at	The timestamp indicating the last update time of the transaction.
data.policy_expiry_date	An ISO date indicating when the policy would expire

These parameters contain different information about the transaction and can be used for additional processing or analysis purposes.