Skip to main content
POST
Create Master Merchant (Vendor) With Default Wallets

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
email
string<email>
required
phone_number
string
required

E.164 format (e.g. +2547xxxxxxx)

first_name
string
required
last_name
string
required
password
string<password>
required

Merchant password (min 6 chars).

kyc_status
enum<string>
required
Available options:
pending,
approved,
rejected
is_active
boolean
default:true
pin
string

Optional 6-digit PIN for PIN-based login.

Pattern: ^[0-9]{6}$

Response

Merchant created with wallets

message
string
merchant
object

Merchant user summary (master vendor or subvendor branch).

wallets
object[]
warning
string

Present when one or more default wallets failed. Create missing wallets manually.

wallet_errors
object[]