Create a customer

POST

customers

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "customerId": "cus_01hxyz",
    "balances": {
      "available": 0,
      "held": 0
    },
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "+2348012345678",
    "walletId": "wal_01hxyz",
    "account": {
      "currency": "NGN",
      "accountNumber": "0123456789",
      "accountName": "Jane Doe",
      "bankName": "Wema Bank",
      "bankCode": "035",
      "provider": "<string>"
    }
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request",
    "details": {}
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request",
    "details": {}
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request",
    "details": {}
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

Authorizations

Authorization

string

header

required

Secret API key. Use sk_test_... for sandbox data or sk_live_... for live data (after verification and live mode). Do not use pk_ keys.

Body

application/json

firstName, lastName, email, and phone. Email must be unique on this merchant account.

firstName

string

required

Given name.

Example:

"Jane"

lastName

string

required

Family name.

Example:

"Doe"

string

required

Example:

"[email protected]"

phone

string

required

Phone must be 10 to 15 digits, optionally starting with +

Example:

"+2348012345678"

Response

Resource created

success

boolean

Example:

true

data

object

Show child attributes

meta

object

Show child attributes

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "customerId": "cus_01hxyz",
    "balances": {
      "available": 0,
      "held": 0
    },
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "+2348012345678",
    "walletId": "wal_01hxyz",
    "account": {
      "currency": "NGN",
      "accountNumber": "0123456789",
      "accountName": "Jane Doe",
      "bankName": "Wema Bank",
      "bankCode": "035",
      "provider": "<string>"
    }
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request",
    "details": {}
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request",
    "details": {}
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request",
    "details": {}
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

customers

escrows

checkout

transactions

wallets

payouts

fees

identity

Authorizations

Body

Response