Skip to main content
POST
/
v1
/
customer
/
create
Create merchant customer
curl --request POST \
  --url https://staging.api.payluk.ng/v1/customer/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstname": "Ada",
  "lastname": "Eze",
  "email": "[email protected]",
  "phone": "+2348012345678",
  "countryId": "665f1b2c9a1e4d0012ab3c40"
}
'
{
  "status": 201,
  "message": "Customer created successfully",
  "data": {
    "id": "665f1b2c9a1e4d0012ab3c01",
    "firstname": "Ada",
    "lastname": "Eze",
    "email": "[email protected]",
    "role": "merchant_user"
  }
}

Authorizations

​
Authorization
string
header
required

Your secret key as a Bearer token. The key prefix selects the environment: sk_test_... (test) or sk_live_... (live).

Body

application/json
​
firstname
string
required
Example:

"Ada"

​
lastname
string
required
Example:

"Eze"

​
email
string<email>
required
​
phone
string
required
Example:

"+2348012345678"

​
countryId
string
required
Example:

"665f1b2c9a1e4d0012ab3c40"

Response

Customer created.

​
status
integer
Example:

200

​
message
string
Example:

"Customer fetched successfully"

​
data
object