Skip to main content

​
🤖 Create a Customer

To add a new customer to your system, use the create customer endpoint. Body
​
firstname
string
required
The customer’s first name. It must match the customer’s government-issued identification for KYC purposes.
​
lastname
string
required
The customer’s last name or surname. It must match the customer’s government-issued identification for KYC purposes.
​
middlename
string
required
The customer’s middle name or initial. This can be used for additional verification and should match the customer’s government-issued identification if provided.
​
country
string
default:"NG"
required
The country of the customer’s residence or operation. Use ISO 3166-1 alpha-2 country codes.
​
email
string
required
The customer’s email address.
Request Body Provide necessary details to set up a new card.
Request Body
{
  "firstname": "user",
  "lastname": "user",
  "middlename": "user",
  "country": "user",
  "email": "[email protected]"
}

​
🔍 Get Customer Details

Retrieve detailed information of a specific customer with their unique identifier using the get customer endpoint. Path Parameters
​
id
string
required
The unique identifier of the customer to retrieve.

​
🔍 Get All Customers

Retrieve a comprehensive list of all customers in your system using the get all customers endpoint. Query Parameters
​
page
string
default:1
required
The page to return.
​
limit
string
default:10
required
The maximum number of results to return.

​
Perform KYC for a Customer

Conduct Know Your Customer (KYC) checks to verify the identity of your customers using the customer KYC endpoint.
Customer KYC is required before issuing a DEFAULT USD collection account for a customer. After KYC is submitted, create a USD collection with currency set to USD and include the required additional_information payload.
Parameters
​
id
string
required
The unique identifier of the customer to retrieve.
Body
  • tier enum (ONE, TWO, FULL) :
    • The amount to fund in the smallest currency unit.
  • information object :
    • bvn string : customer bvn (Nigeria)
    • ssnit string : customer ssnit (Ghana)
    • state string : customer state
    • city string : customer city
    • country string : customer country
    • address string : customer address
    • postal_code string : customer address postal code
    • date_of_birth string : customer date of birth
  • document object :
    • document_type enum (NIN, PASSPORT, DRIVERS_LICENSE)
    • document_number number : customer document number
    • document url : customer document url
    • passport url : customer passport photograph url
Request Body
{
	"tier": "FULL",
	"information": {
		"bvn": "12345678901",
		"state": "Lagos",
		"city": "Ikeja",
		"country": "Nigeria",
		"address": "No 1, Ikeja",
		"postal_code": "100001",
		"date_of_birth": "1990-01-01",
		"phone_number": "08012345678"
	},
	"document": {
		"document_type": "PASSPORT",
		"document_number": "A1234567",
		"document": "https://example.com/document.jpg",
		"passport": "https://example.com/passport.jpg"
	}
}

​
Blacklist Customer

Blacklist customer from performing any action using the post. Parameters
​
id
string
required
The unique identifier of the customer to blacklist.