Skip to main content
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:
  1. Understand the basic structure for creating a business customer.
  2. Learn how to structure API requests for the business customer type.

​
Prerequisites

Before you begin, ensure you have:

​
Creating a Business Customer Account

1

Understand Customer Creation Parameters

The essential parameters for creating a business customer are:
ParameterTypeExample ValueDescription
emailstringjohn95​@​gmail.comThe primary email address for the business contact.
has_accepted_termsbooleantrueIndicates if the terms and conditions have been accepted.
typestringbusinessThe type of customer being created.
country_idstringNGThe ISO 3166-1 alpha-2 country code of the business’s operation.
phonestring+234 8012345678The business’s primary contact phone number, including country code.
birth_datestring24-12-2000The date of birth for a key individual associated with the business.
business_namestringBusha EnterprisesThe legal registered name of the business.
business_industrystringBIN_C4UvTYR5V8jsOx5LmwQA unique identifier representing the business’s industry.
business_incorporation_datestring2019-08-24The 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.
2

Create a Business Customer

Business customers like you represent legal entities that utilize your offerings. Their legal and statutory details identify them.To create a business customer:
  1. Open your terminal or command prompt.
  2. Use the POST request below to the /v1/customers endpoint.
  3. 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"
  }
}

​
Troubleshooting

  • 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?

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