Create A Business Customer

This guide provides a technical walkthrough on programmatically creating a business customer account within your Busha Business account using the Busha API. By automating customer creation, you can streamline your onboarding processes and prepare to perform transactions on behalf of your customers.

What You’ll Achieve:

Understand the basic structure for creating a business customer.
Learn how to structure API requests for the business customer type.

PrerequisitesCopied!

Before you begin, ensure you have:

A Busha Business Account and Secret API Key (from the Quick Start Tutorial).
An understanding of API Environments (Sandbox vs. Production) and their base URLs (from the Make Your First Request Guide).

Step 1: Understand Customer Creation ParametersCopied!

The essential parameters for creating a business customer are:

Parameter	Type	Example Value	Description
`email`	`string`	`john95@gmail.com`	The primary email address for the business contact.
`has_accepted_terms`	`boolean`	`true`	Indicates if the terms and conditions have been accepted.
`type`	`string`	`business`	The type of customer being created.
`country_id`	`string`	`NG`	The ISO 3166-1 alpha-2 country code of the business's operation.
`phone`	`string`	`+234 8012345678`	The business's primary contact phone number, including country code.
`birth_date`	`string`	`24-12-2000`	The date of birth for a key individual associated with the business.
`business_name`	`string`	`Busha Enterprises`	The legal registered name of the business.
`business_industry`	`string`	`BIN_C4UvTYR5V8jsOx5LmwQ`	A unique identifier representing the business's industry.
`business_incorporation_date`	`string`	`2019-08-24`	The date on which the business was officially incorporated.

For business_industry, the list of supported sectors and their unique identifier can be retrieved from Supported Business Industries.

Know Your Business (KYB)

Optionally, you can choose to upload your customer’s KYB documents at the point of creation in the documents array field in the original request body.

Files uploaded for KYB must be in Base64 format and have a file size less than 4MB.

The document array expects the object(s) in this format:

"documents": [
    {
      "purposes": [
        "certificate_of_incorporation"
      ],
      "file": "{{base64 string}}"
   }
]

For a full list of acceptable documents, please refer to the Customer API Reference.

Step 2: Create a Business CustomerCopied!

Business customers like you represent legal entities that utilize your offerings. Their legal and statutory details identify them.

To create a business customer:

Open your terminal or command prompt.
Use the POST request below to the /v1/customers endpoint.
Replace YOUR_BASE_URL with your chosen environment’s URL and {YOUR_SECRET_KEY} with your actual key.

$ curl -i -X POST https://YOUR_BASE_URL/v1/customers \
  -H 'Authorization: Bearer {YOUR_SECRET_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "godisgoodcrypto@gmail.com",
    "has_accepted_terms": true,
    "type": "business",
    "country_id": "NG",
    "phone": "+234 8012345678",
    "birth_date": "24-12-2000",
    "business_name": "Busha Pay",
    "business_industry": "BIN_C4UvTYR5V8jsOx5LmwQ",
    "business_incorporation_date": "2019-08-24"
  }'

Expected Response:

A successful response will return a Customer object, providing the customer id , the type of the customer business) and the status of the customer.

The default status of a customer is inactive until the user completes their Know-Your-Business (KYB) process.

{
  "status": "success",
  "message": "Created customer successfully",
  "data": {
    "address": {
      "address_line_1": "",
      "country_id": ""
    },
    "business_id": "BUS_jlKUYwF9z1ynQZ98bWbaP",
    "business_incorporation_date": "2019-08-24",
    "business_industry": "BIN_C4UvTYR5V8jsOx5LmwQ",
    "business_name": "Busha Pay",
    "country_id": "NG",
    "created_at": "2025-06-26T08:59:30.835471769Z",
    "deposit": true,
    "display_currency": "NGN",
    "email": "godisgoodcrypto@gmail.com",
    "has_accepted_terms_of_service": true,
    "id": "CUS_B912WgfXH0I4U",
    "payout": true,
    "phone": "+234 8012345678",
    "status": "inactive",
    "type": "business",
    "updated_at": "2025-06-26T08:59:30.835471769Z"
  }
}

TroubleshootingCopied!

400 Bad Request / 422 Unprocessable Entity: Review your request body to ensure all required fields are present and correctly formatted for the specified type (individual or business).
401 Unauthorized: Verify that your Secret API Key is correct and included in the header.

What’s Next?Copied!

Now that you can programmatically create business customers, you can proceed to manage them and perform transactions on their behalf:

How to Create an Individual Customer: Learn how to create an individual customer in your Busha business account.
How to Verify Customer’s Identity (KYC/KYB): Learn how to conduct and verify the identity of your customer to allow them full access to Busha’s operations.
How to Initiate Transactions on Behalf of a Customer: Understand how to use the customer_id to perform operations for your customers.