Customers
The Customers section provides access to customer-related data including identity details, contact information, and blacklist status. This allows you to create, manage, and filter customer profiles within your system for transactional and compliance purposes.
Create a new customer
Use Case
This endpoint is used to create a new customer.
Create Customer Request Body
First name of the customer. This is typically used for identification and personalization in communications.
Last name or surname of the customer. Combined with the first name to form the full legal name.
A valid and unique email address used to identify and contact the customer. It also serves as a primary login credential.
Customer’s active phone number, formatted in international standard (e.g., +233XXXXXXXXX). May be used for verification and notifications.
The country dial code used for phone number formatting (e.g., '+234' for Nigeria, '+1' for United States).
Create Customer Response
Returns a Customer Response.
Standard response structure for all customer endpoints.
Universally unique identifier (UUID) assigned to the customer. This ID is used to reference the customer across all systems and APIs.
The customer's given name. Useful for personalization in communications and customer interfaces.
The customer’s family name or surname. When combined with the first name, it forms the customer’s full name.
A unique and valid email address associated with the customer. Used for communication, verification, and login purposes.
Customer’s contact phone number in international format (e.g., +233XXXXXXXXX). May be used for notifications or identity verification.
The country dial code used for phone number formatting (e.g., '+234' for Nigeria, '+1' for United States).
Indicates whether the customer is blacklisted (true) or allowed (false). Blacklisted customers are restricted from performing certain actions.
The date and time when the customer record was initially created, formatted as an ISO 8601 timestamp (e.g., '2024-11-05T12:34:56Z').
The date and time of the most recent update to the customer record, also in ISO 8601 format.
Update Customer
Use Case
This endpoint is used to update an existing customer's information.
The unique identifier of the customer you want to update
Update Customer Request Body
First name of the customer
Customer's phone number
Update Customer Response
Returns an updated CustomerResponse..
Blacklist A Customer
Use Case
This endpoint is used to mark a customer as blacklisted.
Unique identifier of the customer to be blacklisted. This is passed as a path parameter.
Set to true to blacklist the customer, or false to remove them from blacklist.
Blacklisted Customer Response
Returns an updated CustomerResponse. with blacklist: true..
A globally unique identifier (UUID) that uniquely identifies the customer record in the system.
The first or given name of the customer. Used for display and personalization.
The surname or family name of the customer. Useful for full name generation.
A valid and unique email address associated with the customer. Used for communication and identification.
The customer's phone number in international format. Optional but can be used for verification or contact.
The country dial code used for phone number formatting (e.g., '+234' for Nigeria, '+1' for United States).
Indicates if the customer is blacklisted. A value of true means restricted from transactions.
Timestamp (ISO 8601 format) indicating when the customer was created in the system.
Timestamp (ISO 8601 format) of the most recent update made to the customer's profile.
Get Customer by ID, Reference or Email
Use Case
This endpoint is used to retrieve a single customer by id, ref, or email.
Response
Returns a CustomerResponse.
Retrieve customers
Use Case
This endpoint is used to retrieve a list of all customers with optional filtering and pagination.
Query Parameters
Specifies which page of results to fetch. Used for paginating through large sets of customer records. Defaults to 1 if not provided.
Defines the number of customer records returned per page. Useful for controlling result size. Default is 20.
Allows you to filter customers by their email address. Useful when searching for a specific customer.
Set to true to return only blacklisted customers, or false to exclude them. Helps in managing user access.
The country dial code used for phone number formatting (e.g., '+234' for Nigeria, '+1' for United States).
Retrieved Response
Returns a paginated list of CustomerResponse[].
A system-generated universally unique identifier (UUID) for the customer. Used to reference the customer internally.
The customer’s given name. Typically used in user-facing communication or personalization.
The customer’s surname. Helpful for identity verification or formal communications.
The customer's unique email address, used for communication and login. Must follow standard email format.
The customer's mobile number in international format (e.g., +234xxxxxxxxx). Useful for two-factor authentication or support.
The country dial code used for phone number formatting (e.g., '+234' for Nigeria, '+1' for United States).
Boolean flag that indicates if the customer is blacklisted, true means they are blocked from certain actions.
Timestamp in ISO 8601 format indicating when the customer profile was first created.
Timestamp in ISO 8601 format marking the last time the customer profile was updated.