# SME Account

## Background

SME can open the SME Account in Choice Bank through BaaS API Platform. The following 5 types of organizations are eligible to open the SME Account:

1. **Sole Proprietorship**

   A sole proprietorship is a type of enterprise that is owned and run by one individual, with no distinction between the owner and the business entity. The owner is entitled to all profits and is responsible for all the business's debts, losses, and liabilities.
2. **Limited Liability Company**

   A limited liability company is a business structure that combines the pass-through taxation of a partnership or sole proprietorship with the limited liability of a corporation. Owners of an LLC are called members and are protected from personal liability for business debts and claims.
3. **Partnership Company**

   A partnership company is a business organization in which two or more individuals manage and operate a business in accordance with the terms and objectives set out in a Partnership Deed. Partners share profits and losses and are jointly and severally liable for the obligations of the partnership.
4. **NGO (Non-Governmental Organization)**

   A non-governmental organization is a non-profit group that operates independently of any government, typically one whose purpose is to address a social or political issue. NGOs play a critical role in developing society, improving communities, and promoting citizen participation.
5. **CBO (Community-Based Organization)**

   A community-based organization is a non-profit group that works at a local level to improve life for residents. These organizations are typically grassroots entities that are focused on community-based issues and are involved in activities that address the needs of the community.

## Steps

{% stepper %}
{% step %}

### Initiate Onboarding Request

Call endpoint `/onboarding/business/applyForSmeOnboarding` to initiate an onboarding request. On initiation, end users will need to select their SME type and how they would like to receive the OTP (SMS or email).

Status: `1-SUBMITTED`
{% endstep %}

{% step %}

### Confirm OTP

Call endpoint `/common/sendOtp` to request for OTP (using onboardingRequestId received in the response in the first step). 

Call endpoint `/common/confirmOperation` to confirm the OTP code received.

Status: `2-PROCESSING` 

{% hint style="warning" %}
If the OTP is not verified within 30 minutes of submission, the onboarding request will expire.
{% endhint %}
{% endstep %}

{% step %}

### Submit Onboarding Basic Information

Based on the SME's `businessType`, call different endpoints to submit the basic information for onboarding.  Onboardings for Different organizations require different information.

* Sole Proprietorship - `/onboarding/business/submitStoreOnboardingRequest`
* Limited Liability Company - `/onboarding/business/submitCompanyOnboardingRequest`
* Partnership Company - `/onboarding/business/submitPartnershipOnboardingRequest`
* NGO/CBO - `/onboarding/business/submitOrganisationOnboardingRequest`

Status: `2-PROCESSING`
{% endstep %}

{% step %}

### Submit Onboarding Documents

Call endpoint `/onboarding/business/uploadMedia` to submit the onboarding documents. 

Call endpoint `/onboarding/business/removeMedia` to remove the uploaded onboarding documents. 

For the documents required for onboarding, please refer to the table <kbd>Documents</kbd> below
{% endstep %}

{% step %}

### Submit Company Shareholders/Directors/Partners Information

Sole Proprietorship type of company is not required to do this step.

For Limited Liability Company, Partnership Company, NGO and CBO, the information of at least 2 shareholders/directors/partners need to be submitted.&#x20;

* Add Individual shareholder: `/onboarding/business/submitCompanyMember`
* Add organization shareholder: `/onboarding/business/submitShareholderCompanyMember`
* Remove shareholder: `/onboarding/business/removeMember`

Status: `2-PROCESSING`
{% endstep %}

{% step %}

### Submit the Request for Reviewing

When all information & documents are submitted, call endpoint `/onboarding/submitOrPullBackRequest` to send this onboarding to Choice Bank's reviewing.&#x20;

Before it's sent for reviewing, end users' onboarding information can be edited by repeating step 3-5;

After the request is sent for reviewing, the onboarding information can no longer be amended.&#x20;

In case end users find anything wrong about the onboarding information or materials and want to amend it, they can also pull back the request (by calling the same endpoint `/onboarding/business/submitOrPullBackRequest`) and re-edit.&#x20;

Status: `9-MANUAL_REVIEWING`

{% hint style="warning" %}
Once the OTP has been confirmed, the onboarding request is in `2-PROCESSING` status. In this status, end users have 72 hours to complete steps 3-5 by submitting basic information, company documents and shareholder information.\
If the onboarding request is not sent to 9-MANUAL\_REVIEWING within 72 hours, it will expire.
{% endhint %}
{% endstep %}

{% step %}

### Waiting for Reviewing

Status: `9 - MANUAL REVIEWING`&#x20;

End users can request pulling back the request and amend the onboarding information at this stage.
{% endstep %}

{% step %}

### Get Onboarding Result

* Get it from `0006 - SME Account Opening Result Notification`
* Query the result by calling the endpoint
  * Sole Proprietorship: `/onboarding/business/getStoreOnboardingInfo`
  * Limited Liability Company: `/onboarding/business/getCompanyOnboardingInfo`
  * NGO/CBO: `/onboarding/business/getOrganisationOnboardingInfo`
  * Partnership Company: `/onboarding/business/getPartnershipOnboardingInfo`&#x20;
    {% endstep %}
    {% endstepper %}

## Status

<figure><img src="/files/YIpEnPjFFBZ6mlbXUauR" alt=""><figcaption></figcaption></figure>

## Documents

### Sole Proprietorship

<table><thead><tr><th width="122">File ID</th><th width="330.199951171875">Description</th><th width="141">Supported File Type</th><th width="141.599853515625">Required?</th></tr></thead><tbody><tr><td>KYCF00001</td><td>Front side photo of Kenya national ID</td><td>jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00002</td><td>Back side photo of Kenya national ID</td><td>jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00006</td><td>Selfie Photo</td><td>jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00009</td><td>Photo of Kenya Personal KRA PIN Certificate</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00010</td><td>Photo or scan copy of Proprietor Business Certificate</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00029</td><td>Other document files</td><td>pdf, jpg, jpeg</td><td>FALSE</td></tr></tbody></table>

### Limited Liability Company

<table><thead><tr><th width="128">File ID</th><th width="307.5999755859375">Description</th><th width="141.7998046875">File Type</th><th width="190">Required?</th></tr></thead><tbody><tr><td>KYCF00011</td><td>CR12</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00012</td><td>CR2, CR1, CR8 - Memorandum of the Company</td><td>pdf, jpg, jpeg</td><td>FALSE</td></tr><tr><td>KYCF00013</td><td>KRA Pin certificate of Company</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00014</td><td>Original Board Resolutions on company’s letter head</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00023</td><td>Ultimate beneficiary owners</td><td>pdf, jpg, jpeg</td><td>FALSE<br>(unless one shareholder is a company)</td></tr><tr><td>KYCF00024</td><td>Certificate of Incorparation</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00029</td><td>Other document files</td><td>pdf, jpg, jpeg</td><td>FALSE</td></tr></tbody></table>

### Partnership

<table><thead><tr><th width="128">File ID</th><th width="358">Description</th><th width="161">Supported File Type</th><th width="100">Is Required</th></tr></thead><tbody><tr><td>KYCF00013</td><td>KRA Pin certificate of Company</td><td>pdf, jpg, jpeg</td><td>FALSE</td></tr><tr><td>KYCF00014</td><td>Original Board Resolutions on company’s letter head</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00016</td><td>Partnership Certificate of Registration</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00017</td><td>Certified Partnership Deed</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00029</td><td>Other document files</td><td>pdf, jpg, jpeg</td><td>FALSE</td></tr></tbody></table>

### NGO / CBO

<table><thead><tr><th width="128">File ID</th><th width="358">Description</th><th width="161">Supported File Type</th><th width="100">Is Required</th></tr></thead><tbody><tr><td>KYCF00013</td><td>Photo or scan copy of KRA Pin certificate of the company</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00014</td><td>Photo or scan copy of Original Board Resolutions on company’s letter head</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00016</td><td>Certified Copy of Certificate of Registration/Exemption Certificate</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00018</td><td>Photo of scan copy of By-laws / constitutions</td><td>pdf, jpg, jpeg</td><td>TRUE</td></tr><tr><td>KYCF00029</td><td>Other document files</td><td>pdf, jpg, jpeg</td><td>FALSE</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://choice-bank.gitbook.io/choice-bank/account/sme-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.