Customers

Create customer

Provision a customer. USDT and USDC addresses are created immediately. Request any other supported asset address when you need it.

POSThttps://api.vastel.io/api/v1/users

external_user_id is your own id for this person. The call is idempotent on that id. With sandbox keys the customer is stored for tests only and is invisible to live keys.

Send identity as bvn or nin, or as identity_type (bvn or nin) with identity_number. The number is 11 digits.

Body

external_user_id
string · required
Your customer id. Max 128 characters.
full_name
string · required
Legal name.
email
string · required
Email address.
phone
string
Optional phone number.
bvn
string
11-digit BVN. One identity method is required.
nin
string
11-digit NIN.
identity_type
bvn | nin
Use with identity_number.
identity_number
string
11 digits. Required with identity_type.

curl -s -X POST https://api.vastel.io/api/v1/users \
  -H "Content-Type: application/json" \
  -H "X-Public-Key: vst_pub_xxxxxxxx" \
  -H "X-Secret-Key: vst_sec_xxxxxxxx" \
  -d '{
    "external_user_id": "cust_1001",
    "full_name": "Ada Obi",
    "email": "[email protected]",
    "phone": "08031234567",
    "bvn": "22123456789"
  }'

PreviousReset sandbox Next Get customer