Skip to main content
POST
Create merchant customer

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"

bvn
string

Optional 11-digit Bank Verification Number. When provided, the customer is issued a dedicated (permanent) virtual account via Paystack; when omitted, the customer gets a temporary 24-hour virtual account instead.

Required string length: 11
Pattern: ^[0-9]{11}$
Example:

"22222222222"

Response

Customer created.

status
integer
Example:

200

message
string
Example:

"Customer fetched successfully"

data
object