Customer Events

Afriex delivers real-time notifications to your configured webhook URL whenever a customer is created, updated, or deleted.

Security

See Webhooks Introduction for setup, signature validation, and retry behavior.

Event Types

CUSTOMER.CREATED - A new customer has been created
CUSTOMER.UPDATED - Customer information has been updated
CUSTOMER.DELETED - A customer has been deleted

Sample Payloads

Customer Created

{
  "event": "CUSTOMER.CREATED",
  "data": {
    "name": "John Doe",
    "email": "johndoe@gmail.com",
    "phone": "+2348012345678",
    "customerId": "698b0440cba7ec3daee9163d",
    "countryCode": "NG",
    "meta": {
      "source": "whatsapp"
    },
    "createdAt": "2026-02-10T10:11:12.415Z",
    "updatedAt": "2026-02-10T10:11:12.415Z"
  }
}

Customer Updated

{
  "event": "CUSTOMER.UPDATED",
  "data": {
    "name": "John Smith",
    "email": "johnsmith@gmail.com",
    "phone": "+2348012345678",
    "customerId": "698b0440cba7ec3daee9163d",
    "countryCode": "NG",
    "meta": {
      "source": "whatsapp",
      "verified": true
    },
    "createdAt": "2026-02-10T10:11:12.415Z",
    "updatedAt": "2026-02-11T15:30:45.123Z"
  }
}

Customer Deleted

{
  "event": "CUSTOMER.DELETED",
  "data": {
    "name": "John Smith",
    "email": "johnsmith@gmail.com",
    "phone": "+2348012345678",
    "customerId": "698b0440cba7ec3daee9163d",
    "countryCode": "NG",
    "meta": {
      "source": "whatsapp",
      "verified": true
    },
    "createdAt": "2026-02-10T10:11:12.415Z",
    "updatedAt": "2026-02-11T15:30:45.123Z"
  }
}

The event field will be CUSTOMER.CREATED, CUSTOMER.UPDATED, or CUSTOMER.DELETED depending on the action that triggered the notification. Delete events carry the same full customer object as create and update events. Afriex reads the record before removing it and sends it in full, so CUSTOMER.DELETED gives you the customer’s last known state. There is no slimmed-down delete payload and no deletedAt field.

Response

Return 200 (or another 2xx) after successful validation and processing.

Overview

Core Concepts

Balance

Checkout Sessions

Rates

Customers

Payment Methods

Transactions

Webhooks

Media

SME Registration

Security

Event Types

Sample Payloads

Customer Created

Customer Updated

Customer Deleted

Response

​Security

​Event Types

​Sample Payloads

​Customer Created

​Customer Updated

​Customer Deleted

​Response

Security

Event Types

Sample Payloads

Customer Created

Customer Updated

Customer Deleted

Response