Create Customer

• Endpoint

POST: https://api.xixapay.com/api/customer/create

📄 Description

Creates a new customer associated with a business and submits their KYC (Know Your Customer) details for verification. This includes personal information, address, ID type and number, and uploads of identification and utility bill documents.

Request Headers

Authorization	Beaerer {Secrete_KEY}
api-key	{API_KEY}
Content-Type	application/json

Request Body

Field	Type	Required	Description
first_name	string	✅	Customer's first name
last_name	string	✅	Customer's last name
email	string	✅	Valid email address
phone_number	string	✅	Nigerian phone number (11 digits)
address	string	✅	Residential address
state	string	✅	State of residence
city	string	✅	City of residence
postal_code	string	✅	Postal code
date_of_birth	string	✅	Must be at least 14 years old (YYYY-MM-DD)
id_type	string	✅	One of: bvn, nin
id_number	string	✅	ID number, validated based on id_type
id_card	file	✅	JPEG, PNG, or PDF file (max: 5MB)
utility_bill	file	✅	JPEG, PNG, or PDF file (max: 5MB)
businessId	string	✅	The business ID this customer belongs to

📥 Example Request (JSON)

// Some code

{
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "[email protected]",
  "phone_number": "08012345678",
  "address": "10 Market Street",
  "state": "Lagos",
  "city": "Ikeja",
  "postal_code": "100001",
  "date_of_birth": "2008-05-01",
  "id_type": "bvn",
  "id_number": "22123456789",
  "businessId": "abc123"
}

🔍 Note: Files like id_card and utility_bill should be submitted as part of a multipart/form-data request.

✅ Successful Response

{
  "status": true,
  "message": "Customer created successfully",
  "customer": {
    "customer_name": "Jane Doe",
    "customer_email": "[email protected]",
    "customer_id": "9a4c73d7d8ff9..."
  }
}