> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stablestack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Business

> API reference for creating business customer accounts

Creates a new business customer account with comprehensive KYC processing.

### Key Features:

* Comprehensive business information collection
* Business-specific validation rules
* Email and phone uniqueness validation
* Support for business owners/associated persons
* Document upload for compliance
* Returns complete business profile with financial info

### Request Body:

```json theme={null}
{
  "customer_type": "business",
  "business_name": "Akande Enterprises",
  "business_type": "LIMITED_LIABILITY_COMPANY",
  "business_website": "https://akandeyu.com",
  "email": "contact@akandeyu.com",
  "phone": "+2347918905668",
  "account_purpose": "OPERATING_A_COMPANY",
  "source_of_funds": "SALES_OF_GOODS_AND_SERVICES",
  "expected_monthly_income": 5000000,
  "trading_name": "Akande Trading Co",
  "nature_of_business": "Retail and e-commerce operations",
  "industry": "541512",
  "contact_person_email": "ceo@akandeyu.com",
  "contact_person_phone": "+2347918905669",
  "registered_address": {
    "street1": "456 Corporate Plaza",
    "street2": "Floor 5",
    "city": "Lagos",
    "state": "LA",
    "postal_code": "214578",
    "country": "NG"
  },
  "estimated_annual_revenue_usd": "HUNDRED_THOUSAND_TO_MILLION",
  "operates_in_prohibited_countries": false,
  "is_dao": false,
  "conducts_money_services": false,
  "registration_number": "REG123456789",
  "registration_date": "2020-01-15",
  "tax_identification_number": "TIN123456789",
  "phone_country_code": "+234",
  "account_purpose_explanation": "To facilitate international payments for our e-commerce business and manage supplier payments",
  "expected_monthly_payments_usd": 10000,
  "business_owners": [
    {
      "first_name": "Adebayo",
      "last_name": "Akande",
      "email": "adebayo@akandeyu.com",
      "phone_number": "+2347918905670",
      "date_of_birth": "1985-03-20",
      "relationship_establishment_date": "2020-01-15",
      "ownership_percentage": 60,
      "is_control_person": true,
      "is_signer": true,
      "is_beneficial_owner": true,
      "title": "Chief Executive Officer",
      "address": {
        "street1": "789 Owner Ave",
        "street2": "Apt 123",
        "city": "Lagos",
        "state": "LA",
        "postal_code": "214578",
        "country": "NG"
      },
      "id_number": "ID123456789",
      "nationality": "NG",
      "front_image": "https://example.com/id-front.jpg",
      "supporting_documents": [
        {
          "doc_type": "IDENTITY_DOCUMENT",
          "doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
          "doc_country": "NG"
        },
        {
          "doc_type": "PROOF_OF_ADDRESS",
          "doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
          "doc_country": "NG"
        }
      ]
    }
  ],
  "documents": [
    {
      "doc_type": "BUSINESS_FORMATION",
      "doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
      "doc_country": "NG"
    },
    {
      "doc_type": "PROOF_OF_TAX_IDENTIFICATION",
      "doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
      "doc_country": "NG",
      "sub_type":""
    }
  ]
}
```

### Enhanced Business Fields:

* **trading\_name**: Trading or DBA name if different from legal name
* **nature\_of\_business**: Description of business activities
* **industry**: Industry classification (use NAICS codes like "541512" for Computer Systems Design)
* **contact\_person\_email**: Contact person email address
* **contact\_person\_phone**: Contact person phone number
* **registered\_address**: Official registered business address
* **estimated\_annual\_revenue\_usd**: Estimated annual revenue range in USD (enum values: "UNDER\_HUNDRED\_THOUSAND", "HUNDRED\_THOUSAND\_TO\_MILLION", "MILLION\_TO\_TEN\_MILLION", "TEN\_MILLION\_TO\_FIFTY\_MILLION", "FIFTY\_MILLION\_TO\_HUNDRED\_MILLION", "OVER\_HUNDRED\_MILLION")
* **operates\_in\_prohibited\_countries**: Whether business operates in prohibited countries
* **is\_dao**: Whether the business is a DAO
* **conducts\_money\_services**: Whether the business conducts money services activities (e.g., money transmission, currency exchange, payment processing)
* **registration\_number**: Business registration number
* **registration\_date**: Business registration date
* **business\_owners**: Array of business owners/associated persons
* **supporting\_documents**: Array of additional supporting documents for business owners (identity documents, proof of address, etc.)
* **documents**: Array of supporting documents for KYC

### Business Owners Array:

Each business owner object should include personal information, ownership details, and identification documents for compliance purposes. The `supporting_documents` field within each business owner allows for additional documentation beyond the primary `front_image` identification.

<Info>
  **Required Supporting Documents:**

  **For Business Documents:**

  * `BUSINESS_FORMATION` (incorporation certificate)
  * `OWNERSHIP_INFORMATION` (articles of incorporation)
  * `BANK_STATEMENT` (business bank statement)

  **For Business Owners:**

  * `PROOF_OF_ADDRESS` (e.g., utility bill, bank statement, etc.)
</Info>

### Document Requirements:

Common document types for business customers:

* `BUSINESS_FORMATION` (incorporation certificate)
* `PROOF_OF_TAX_IDENTIFICATION` (tax certificate)
* `REGULATORY_LICENSE_REGISTRATION` (business license)
* `PROOF_OF_NATURE_OF_BUSINESS` (memorandum of association)
* `OWNERSHIP_INFORMATION` (articles of incorporation)


## OpenAPI

````yaml POST /business-customers
openapi: 3.0.0
info:
  title: 'StableStack: API Service'
  description: "# Overview\n\n##  Introduction\n\nStableStack offers an API first, last mile payment orchestration + liquidity router built with stablecoins. Stablecoin layer integrated into your existing payment flow, with smart accounts and blockchain abstraction. Go between digital and fiat currencies in minutes.\n\n## Getting Help\n\nWe're excited to have you build with us! If you're integrating, we will set up a communication channel. This will enable our teams to easily collaborate and ensure you launch as quickly as possible.\n\nPlease reach out to us at\_[hello@stablestack.xyz](https://mailto:hello@stablestack.xyz)\_for any questions or concerns."
  version: 1.0.0
servers:
  - url: https://api-staging.stablestack.com/api
    description: StableStack API
security: []
tags:
  - name: customers
  - name: customers > kyc
  - name: payouts
  - name: banks
  - name: transactions
  - name: wallets
  - name: assets
  - name: swap
paths:
  /business-customers:
    post:
      tags:
        - business customers
      summary: Create business customer
      parameters:
        - name: x-api-key
          in: header
          schema:
            type: string
          required: true
          example: ''
      requestBody:
        description: Create a new business customer account
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessCustomer'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessCustomerResponse'
components:
  schemas:
    BusinessCustomer:
      type: object
      required:
        - customer_type
        - business_name
        - business_type
        - business_website
        - email
        - phone
        - account_purpose
        - source_of_funds
        - expected_monthly_income
        - registered_address
        - industry
        - estimated_annual_revenue_usd
        - trading_name
        - nature_of_business
        - contact_person_email
        - contact_person_phone
        - operates_in_prohibited_countries
        - is_dao
        - registration_number
        - registration_date
        - tax_identification_number
        - phone_country_code
        - conducts_money_services
        - account_purpose_explanation
        - expected_monthly_payments_usd
        - business_owners
        - documents
      properties:
        customer_type:
          type: string
          enum:
            - business
          default: business
        business_name:
          type: string
          example: Example Enterprises
          description: Legal name of the business
        business_type:
          type: string
          enum:
            - B_CORPORATION
            - C_CORPORATION
            - S_CORPORATION
            - CLOSE_CORPORATION
            - COOPERATIVE
            - GENERAL_PARTNERSHIP
            - LIMITED_PARTNERSHIP
            - LIMITED_LIABILITY_PARTNERSHIP
            - LIMITED_LIABILITY_COMPANY
            - NONPROFIT_CORPORATION
            - SOLE_PROPRIETORSHIP
            - TRUST
            - NON_US
          example: LIMITED_LIABILITY_COMPANY
          description: Legal structure of the business
        business_website:
          type: string
          format: uri
          example: https://example.com
          description: Business website URL (Recommended)
        email:
          type: string
          format: email
          example: contact@example.com
          description: Business email address
        phone:
          type: string
          pattern: ^\+[1-9]\d{1,14}$
          example: '+14155552671'
          description: Business phone number with country code e.g +14155552671
        account_purpose:
          type: string
          enum:
            - CHARITABLE_DONATIONS
            - ECOMMERCE_RETAIL_PAYMENTS
            - INVESTMENT_PURPOSES
            - OPERATING_A_COMPANY
            - PAYMENTS_TO_FRIENDS_OR_FAMILY_ABROAD
            - OTHER
            - PERSONAL_OR_LIVING_EXPENSES
            - PROTECT_WEALTH
            - PURCHASE_GOODS_AND_SERVICES
            - RECEIVE_PAYMENT_FOR_FREELANCING
            - RECEIVE_SALARY
          example: OPERATING_A_COMPANY
          description: Primary purpose for using the account
        source_of_funds:
          type: string
          enum:
            - BUSINESS_LOANS
            - GRANTS
            - INTER_COMPANY_FUNDS
            - INVESTMENT_PROCEEDS
            - LEGAL_SETTLEMENT
            - OWNERS_CAPITAL
            - PENSION_RETIREMENT
            - SALE_OF_ASSETS
            - SALES_OF_GOODS_AND_SERVICES
            - TAX_REFUND
            - THIRD_PARTY_FUNDS
            - TREASURY_RESERVES
            - ASSETS_SALE
            - BUSINESS_INCOME
            - CASH_DEPOSITS
            - COMPANY_FUNDS
            - ECOMMERCE_RESELLER
            - GAMBLING_PROCEEDS
            - GIFTS
            - GOVERNMENT_BENEFITS
            - INHERITANCE
            - INVESTMENTS_LOANS
            - SALARY
            - SALE_OF_ASSETS_REAL_ESTATE
            - SAVINGS
            - SOMEONE_ELSES_FUNDS
          example: SALES_OF_GOODS_AND_SERVICES
          description: Primary source of funds for the business
        expected_monthly_income:
          type: number
          minimum: 0
          example: 5000000
          description: Expected monthly income in local currency
        industry:
          type: string
          enum:
            - '111120'
            - '111219'
            - '111336'
            - '111421'
            - '111998'
            - '112111'
            - '112210'
            - '112310'
            - '112410'
            - '112519'
            - '112990'
            - '113110'
            - '113210'
            - '113310'
            - '114119'
            - '114210'
            - '115113'
            - '115210'
            - '115310'
            - '211130'
            - '212114'
            - '212290'
            - '212390'
            - '213113'
            - '221122'
            - '221210'
            - '221320'
            - '236118'
            - '236210'
            - '237130'
            - '237210'
            - '237310'
            - '237990'
            - '238191'
            - '238211'
            - '238391'
            - '238991'
            - '311119'
            - '311212'
            - '311314'
            - '311422'
            - '311511'
            - '311612'
            - '311710'
            - '311811'
            - '311999'
            - '312111'
            - '312230'
            - '313110'
            - '313240'
            - '313310'
            - '314120'
            - '314999'
            - '315120'
            - '315250'
            - '315990'
            - '316110'
            - '316210'
            - '316990'
            - '321113'
            - '321211'
            - '321918'
            - '322120'
            - '322299'
            - '323120'
            - '324110'
            - '325180'
            - '325220'
            - '325320'
            - '325412'
            - '325510'
            - '325611'
            - '325998'
            - '326111'
            - '326220'
            - '327120'
            - '327212'
            - '327310'
            - '327410'
            - '327999'
            - '331110'
            - '331210'
            - '331313'
            - '331410'
            - '331511'
            - '332111'
            - '332215'
            - '332311'
            - '332410'
            - '332510'
            - '332613'
            - '332710'
            - '332812'
            - '332999'
            - '333111'
            - '333248'
            - '333310'
            - '333413'
            - '333517'
            - '333611'
            - '333618'
            - '334118'
            - '334210'
            - '334310'
            - '334413'
            - '334511'
            - '334610'
            - '335131'
            - '335220'
            - '335311'
            - '335999'
            - '336110'
            - '336211'
            - '336390'
            - '336412'
            - '336510'
            - '336611'
            - '336999'
            - '337122'
            - '337214'
            - '337920'
            - '339112'
            - '339999'
            - '423120'
            - '423220'
            - '423310'
            - '423490'
            - '423520'
            - '423620'
            - '423710'
            - '423840'
            - '423990'
            - '424110'
            - '424210'
            - '424310'
            - '424490'
            - '424590'
            - '424690'
            - '424720'
            - '424820'
            - '424990'
            - '425120'
            - '441110'
            - '441227'
            - '441330'
            - '449110'
            - '449129'
            - '449210'
            - '444180'
            - '444240'
            - '445110'
            - '445298'
            - '445320'
            - '456110'
            - '457110'
            - '458110'
            - '458210'
            - '458320'
            - '459120'
            - '459210'
            - '455110'
            - '455219'
            - '459310'
            - '459410'
            - '459510'
            - '459999'
            - '454113'
            - '445132'
            - '454390'
            - '481111'
            - '481211'
            - '482111'
            - '483112'
            - '483212'
            - '484110'
            - '484220'
            - '485119'
            - '485210'
            - '485310'
            - '485410'
            - '485510'
            - '485999'
            - '486110'
            - '486210'
            - '486990'
            - '487110'
            - '487210'
            - '487990'
            - '488190'
            - '488210'
            - '488390'
            - '488490'
            - '488510'
            - '488999'
            - '492110'
            - '492210'
            - '493190'
            - '513130'
            - '513210'
            - '512199'
            - '512290'
            - '516120'
            - '515210'
            - '517111'
            - '517112'
            - '517410'
            - '517810'
            - '518210'
            - '519290'
            - '521110'
            - '522130'
            - '522298'
            - '522390'
            - '523150'
            - '523210'
            - '523999'
            - '524128'
            - '524298'
            - '525190'
            - '525910'
            - '531190'
            - '531210'
            - '531390'
            - '532111'
            - '532289'
            - '532310'
            - '532490'
            - '533110'
            - '541199'
            - '541213'
            - '541310'
            - '541490'
            - '541512'
            - '541618'
            - '541720'
            - '541810'
            - '541690'
            - '551114'
            - '561110'
            - '561210'
            - '561311'
            - '561499'
            - '561599'
            - '561611'
            - '561790'
            - '561990'
            - '562111'
            - '562211'
            - '562998'
            - '611110'
            - '611210'
            - '611310'
            - '611420'
            - '611519'
            - '611699'
            - '611710'
            - '621111'
            - '621210'
            - '621399'
            - '621498'
            - '621511'
            - '621610'
            - '621999'
            - '622110'
            - '622210'
            - '622310'
            - '623110'
            - '623210'
            - '623311'
            - '623990'
            - '624190'
            - '624230'
            - '624310'
            - '624410'
            - '711190'
            - '711219'
            - '711310'
            - '711410'
            - '711510'
            - '712120'
            - '713110'
            - '713290'
            - '713990'
            - '721199'
            - '721211'
            - '721310'
            - '722310'
            - '722410'
            - '722511'
            - '811198'
            - '811210'
            - '811310'
            - '811411'
            - '812199'
            - '812210'
            - '812320'
            - '812990'
            - '813110'
            - '813211'
            - '813319'
            - '813410'
            - '813930'
            - '814110'
            - '921140'
            - '922190'
            - '923130'
            - '924110'
            - '925120'
            - '926110'
            - '927110'
            - '928110'
          example: '541512'
          description: >-
            Industry classification based on NAICS codes - use the code value
            for API requests
        registered_address:
          $ref: '#/components/schemas/RegisteredAddress'
        trading_name:
          type: string
          example: Example Trading Co
          description: Trading or DBA name if different from legal name
        nature_of_business:
          type: string
          maxLength: 500
          example: >-
            Online retail and e-commerce platform specializing in consumer
            electronics
          description: Detailed description of business activities
        contact_person_email:
          type: string
          format: email
          example: ceo@example.com
          description: Contact person email address
        contact_person_phone:
          type: string
          pattern: ^\+[1-9]\d{1,14}$
          example: '+2347918945669'
          description: Contact person phone number
        estimated_annual_revenue_usd:
          type: string
          enum:
            - UNDER_HUNDRED_THOUSAND
            - HUNDRED_THOUSAND_TO_MILLION
            - MILLION_TO_TEN_MILLION
            - TEN_MILLION_TO_FIFTY_MILLION
            - FIFTY_MILLION_TO_HUNDRED_MILLION
            - OVER_HUNDRED_MILLION
          example: HUNDRED_THOUSAND_TO_MILLION
          description: Estimated annual revenue range in USD
        operates_in_prohibited_countries:
          type: boolean
          default: false
          description: Whether business operates in prohibited countries
        is_dao:
          type: boolean
          default: false
          description: >-
            Whether the business is a DAO (Decentralized Autonomous
            Organization)
        registration_number:
          type: string
          example: REG123456789
          description: Business registration number
        registration_date:
          type: string
          format: date
          example: '2020-01-15'
          description: Business registration date
        tax_identification_number:
          type: string
          example: TIN123456789
          description: Tax identification number
        phone_country_code:
          type: string
          pattern: ^\+[1-9]\d{0,3}$
          example: '+234'
          description: Country code for phone number
        conducts_money_services:
          type: boolean
          default: false
          description: >-
            Whether the business conducts money services activities (e.g., money
            transmission, currency exchange, payment processing)
        account_purpose_explanation:
          type: string
          maxLength: 1000
          example: >-
            To facilitate international payments for our e-commerce business and
            manage supplier relationships
          description: Detailed explanation of account purpose
        expected_monthly_payments_usd:
          type: number
          minimum: 0
          example: 10000
          description: Expected monthly payments in USD
        business_owners:
          type: array
          description: >-
            Array of business owners/associated persons (required for certain
            business types)
          items:
            $ref: '#/components/schemas/BusinessOwner'
        documents:
          type: array
          description: Array of supporting documents for KYC verification
          items:
            $ref: '#/components/schemas/UserDocument'
    BusinessCustomerResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        data:
          $ref: '#/components/schemas/BusinessCustomerData'
    RegisteredAddress:
      type: object
      description: Address information (used for both individual and business customers)
      required:
        - street1
        - city
        - state
        - postal_code
        - country
      properties:
        street1:
          type: string
          minLength: 1
          maxLength: 100
          example: 123 Main St
          description: Primary address line
        street2:
          type: string
          maxLength: 100
          example: Suite 456
          description: Secondary address line (optional)
        city:
          type: string
          minLength: 1
          maxLength: 50
          example: Lagos
          description: City name
        state:
          type: string
          minLength: 1
          maxLength: 50
          example: DE
          description: >-
            State or province code with country prefix (e.g., DE for Delware, LA
            for Lagos)
        postal_code:
          type: string
          minLength: 1
          maxLength: 20
          example: '214578'
          description: Postal or ZIP code
        country:
          type: string
          enum:
            - AF
            - AL
            - DZ
            - AD
            - AO
            - AG
            - AR
            - AM
            - AU
            - AT
            - AZ
            - BS
            - BH
            - BD
            - BB
            - BY
            - BE
            - BZ
            - BJ
            - BT
            - BO
            - BA
            - BW
            - BR
            - BN
            - BG
            - BF
            - BI
            - CV
            - KH
            - CM
            - CA
            - CF
            - TD
            - CL
            - CN
            - CO
            - KM
            - CG
            - CR
            - HR
            - CU
            - CY
            - CZ
            - CD
            - DK
            - DJ
            - DM
            - DO
            - EC
            - EG
            - SV
            - GQ
            - ER
            - EE
            - SZ
            - ET
            - FJ
            - FI
            - FR
            - GA
            - GM
            - GE
            - DE
            - GH
            - GR
            - GD
            - GT
            - GN
            - GW
            - GY
            - HT
            - HN
            - HU
            - IS
            - IN
            - ID
            - IR
            - IQ
            - IE
            - IL
            - IT
            - JM
            - JP
            - JO
            - KZ
            - KE
            - KI
            - KW
            - KG
            - LA
            - LV
            - LB
            - LS
            - LR
            - LY
            - LI
            - LT
            - LU
            - MG
            - MW
            - MY
            - MV
            - ML
            - MT
            - MH
            - MR
            - MU
            - MX
            - FM
            - MD
            - MC
            - MN
            - ME
            - MA
            - MZ
            - MM
            - NA
            - NR
            - NP
            - NL
            - NZ
            - NI
            - NE
            - NG
            - KP
            - MK
            - 'NO'
            - OM
            - PK
            - PW
            - PS
            - PA
            - PG
            - PY
            - PE
            - PH
            - PL
            - PT
            - QA
            - RO
            - RU
            - RW
            - KN
            - LC
            - VC
            - WS
            - SM
            - ST
            - SA
            - SN
            - RS
            - SC
            - SL
            - SG
            - SK
            - SI
            - SB
            - SO
            - ZA
            - KR
            - SS
            - ES
            - LK
            - SD
            - SR
            - SE
            - CH
            - SY
            - TW
            - TJ
            - TZ
            - TH
            - TL
            - TG
            - TO
            - TT
            - TN
            - TR
            - TM
            - TV
            - UG
            - UA
            - AE
            - GB
            - US
            - UY
            - UZ
            - VU
            - VA
            - VE
            - VN
            - YE
            - ZM
            - ZW
          example: NG
          description: ISO 3166-1 alpha-2 country code
    BusinessOwner:
      type: object
      description: Business owner or associated person information
      required:
        - first_name
        - last_name
        - email
        - phone_number
        - date_of_birth
        - relationship_establishment_date
        - ownership_percentage
        - is_control_person
        - is_signer
        - is_beneficial_owner
        - title
        - address
        - id_number
        - nationality
        - front_image
        - supporting_documents
      properties:
        first_name:
          type: string
          minLength: 1
          maxLength: 50
          example: Jane
          description: First name of the business owner
        last_name:
          type: string
          minLength: 1
          maxLength: 50
          example: Smith
          description: Last name of the business owner
        email:
          type: string
          format: email
          example: jane.smith@example.com
          description: Email address of the business owner
        phone_number:
          type: string
          pattern: ^\+[1-9]\d{1,14}$
          example: '+2348918945670'
          description: Phone number with country code
        date_of_birth:
          type: string
          format: date
          example: '1985-03-20'
          description: Date of birth (must be 18+ years old)
        relationship_establishment_date:
          type: string
          format: date
          example: '2020-01-15'
          description: Date when relationship with business was established YYYY-MM-DD
        ownership_percentage:
          type: number
          minimum: 0
          maximum: 100
          example: 25.5
          description: Percentage ownership in the business (0-100)
        is_control_person:
          type: boolean
          default: false
          description: Whether this person has control over the business
        is_signer:
          type: boolean
          default: false
          description: Whether this person is an authorized signer
        is_beneficial_owner:
          type: boolean
          default: false
          description: Whether this person is a beneficial owner (typically 25%+ ownership)
        title:
          type: string
          enum:
            - CEO
            - CFO
            - CTO
            - COO
            - President
            - Vice President
            - Director
            - Manager
            - Partner
            - Owner
            - Founder
            - Co-Founder
            - Board Member
            - Secretary
            - Treasurer
            - Other
          example: Chief Executive Officer
          description: Official title within the business
        address:
          type: object
          description: Business owner's address
          required:
            - street1
            - city
            - state
            - postal_code
            - country
          properties:
            street1:
              type: string
              minLength: 1
              maxLength: 100
              example: 789 Owner Ave
              description: Primary address line
            street2:
              type: string
              maxLength: 100
              example: Apt 123
              description: Secondary address line (optional)
            city:
              type: string
              minLength: 1
              maxLength: 50
              example: TX
              description: City name
            state:
              type: string
              minLength: 1
              maxLength: 50
              example: LA
              description: State or province
            postal_code:
              type: string
              minLength: 1
              maxLength: 20
              example: '214578'
              description: Postal or ZIP code
            country:
              type: string
              example: US
              description: Country name
        id_number:
          type: string
          example: ID123456789
          description: PASSPORT  Number
        nationality:
          type: string
          enum:
            - AF
            - AL
            - DZ
            - AD
            - AO
            - AG
            - AR
            - AM
            - AU
            - AT
            - AZ
            - BS
            - BH
            - BD
            - BB
            - BY
            - BE
            - BZ
            - BJ
            - BT
            - BO
            - BA
            - BW
            - BR
            - BN
            - BG
            - BF
            - BI
            - CV
            - KH
            - CM
            - CA
            - CF
            - TD
            - CL
            - CN
            - CO
            - KM
            - CG
            - CR
            - HR
            - CU
            - CY
            - CZ
            - CD
            - DK
            - DJ
            - DM
            - DO
            - EC
            - EG
            - SV
            - GQ
            - ER
            - EE
            - SZ
            - ET
            - FJ
            - FI
            - FR
            - GA
            - GM
            - GE
            - DE
            - GH
            - GR
            - GD
            - GT
            - GN
            - GW
            - GY
            - HT
            - HN
            - HU
            - IS
            - IN
            - ID
            - IR
            - IQ
            - IE
            - IL
            - IT
            - JM
            - JP
            - JO
            - KZ
            - KE
            - KI
            - KW
            - KG
            - LA
            - LV
            - LB
            - LS
            - LR
            - LY
            - LI
            - LT
            - LU
            - MG
            - MW
            - MY
            - MV
            - ML
            - MT
            - MH
            - MR
            - MU
            - MX
            - FM
            - MD
            - MC
            - MN
            - ME
            - MA
            - MZ
            - MM
            - NA
            - NR
            - NP
            - NL
            - NZ
            - NI
            - NE
            - NG
            - KP
            - MK
            - 'NO'
            - OM
            - PK
            - PW
            - PS
            - PA
            - PG
            - PY
            - PE
            - PH
            - PL
            - PT
            - QA
            - RO
            - RU
            - RW
            - KN
            - LC
            - VC
            - WS
            - SM
            - ST
            - SA
            - SN
            - RS
            - SC
            - SL
            - SG
            - SK
            - SI
            - SB
            - SO
            - ZA
            - KR
            - SS
            - ES
            - LK
            - SD
            - SR
            - SE
            - CH
            - SY
            - TW
            - TJ
            - TZ
            - TH
            - TL
            - TG
            - TO
            - TT
            - TN
            - TR
            - TM
            - TV
            - UG
            - UA
            - AE
            - GB
            - US
            - UY
            - UZ
            - VU
            - VA
            - VE
            - VN
            - YE
            - ZM
            - ZW
          example: NG
          description: ISO 3166-1 alpha-2 nationality code of the business owner
        front_image:
          type: string
          format: uri
          example: https://example.com/id-front.jpg
          description: URL to front image of ID document
        back_image:
          type: string
          format: uri
          example: https://example.com/id-back.jpg
          description: URL to back image of ID document (optional)
        supporting_documents:
          type: array
          description: Array of supporting documents for business owner KYC verification
          items:
            $ref: '#/components/schemas/UserDocument'
    UserDocument:
      type: object
      description: Supporting document for KYC verification
      required:
        - doc_type
        - doc_image
        - doc_country
      properties:
        doc_type:
          type: string
          enum:
            - AML_COMFORT_LETTER
            - BUSINESS_FORMATION
            - DIRECTORS_REGISTRY
            - E_SIGNATURE_CERTIFICATE
            - EVIDENCE_OF_GOOD_STANDING
            - FLOW_OF_FUNDS
            - MARKETING_MATERIALS
            - OWNERSHIP_CHART
            - OWNERSHIP_INFORMATION
            - PROOF_OF_ACCOUNT_PURPOSE
            - BANK_STATEMENT
            - PROOF_OF_ADDRESS
            - PROOF_OF_INDIVIDUAL_NAME_CHANGE
            - PROOF_OF_ENTITY_NAME_CHANGE
            - PROOF_OF_NATURE_OF_BUSINESS
            - PROOF_OF_RELATIONSHIP
            - PROOF_OF_SIGNATORY_AUTHORITY
            - PROOF_OF_SOURCE_OF_FUNDS
            - PROOF_OF_SOURCE_OF_WEALTH
            - PROOF_OF_TAX_IDENTIFICATION
            - LIVENESS_CHECK
            - SELFIE
            - SHAREHOLDER_REGISTER
            - OTHER
          example: valid_ids
          description: >-
            Type of document being submitted - supports both individual and
            business KYC requirements
        sub_type:
          type: string
          enum:
            - UTILITY_BILL
            - BANK_STATEMENT
            - TAX_DOCUMENT
            - GOVERNMENT_CORRESPONDENCE
            - RENTAL_AGREEMENT
          example: front
          description: Sub-type of document if applicable (e.g., front/back of ID)
        doc_image:
          type: string
          format: byte
          example: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...
          description: Base64 encoded image data or URL to document image
        doc_country:
          type: string
          enum:
            - AF
            - AL
            - DZ
            - AD
            - AO
            - AG
            - AR
            - AM
            - AU
            - AT
            - AZ
            - BS
            - BH
            - BD
            - BB
            - BY
            - BE
            - BZ
            - BJ
            - BT
            - BO
            - BA
            - BW
            - BR
            - BN
            - BG
            - BF
            - BI
            - CV
            - KH
            - CM
            - CA
            - CF
            - TD
            - CL
            - CN
            - CO
            - KM
            - CG
            - CR
            - HR
            - CU
            - CY
            - CZ
            - CD
            - DK
            - DJ
            - DM
            - DO
            - EC
            - EG
            - SV
            - GQ
            - ER
            - EE
            - SZ
            - ET
            - FJ
            - FI
            - FR
            - GA
            - GM
            - GE
            - DE
            - GH
            - GR
            - GD
            - GT
            - GN
            - GW
            - GY
            - HT
            - HN
            - HU
            - IS
            - IN
            - ID
            - IR
            - IQ
            - IE
            - IL
            - IT
            - JM
            - JP
            - JO
            - KZ
            - KE
            - KI
            - KW
            - KG
            - LA
            - LV
            - LB
            - LS
            - LR
            - LY
            - LI
            - LT
            - LU
            - MG
            - MW
            - MY
            - MV
            - ML
            - MT
            - MH
            - MR
            - MU
            - MX
            - FM
            - MD
            - MC
            - MN
            - ME
            - MA
            - MZ
            - MM
            - NA
            - NR
            - NP
            - NL
            - NZ
            - NI
            - NE
            - NG
            - KP
            - MK
            - 'NO'
            - OM
            - PK
            - PW
            - PS
            - PA
            - PG
            - PY
            - PE
            - PH
            - PL
            - PT
            - QA
            - RO
            - RU
            - RW
            - KN
            - LC
            - VC
            - WS
            - SM
            - ST
            - SA
            - SN
            - RS
            - SC
            - SL
            - SG
            - SK
            - SI
            - SB
            - SO
            - ZA
            - KR
            - SS
            - ES
            - LK
            - SD
            - SR
            - SE
            - CH
            - SY
            - TW
            - TJ
            - TZ
            - TH
            - TL
            - TG
            - TO
            - TT
            - TN
            - TR
            - TM
            - TV
            - UG
            - UA
            - AE
            - GB
            - US
            - UY
            - UZ
            - VU
            - VA
            - VE
            - VN
            - YE
            - ZM
            - ZW
          example: NG
          description: ISO 3166-1 alpha-2 country code where document was issued
    BusinessCustomerData:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: e927caad-9576-40d8-b87d-ace687afa82a
        customer_type:
          type: string
          example: business
        email:
          type: string
          example: contact@example.com
        phone:
          type: string
          example: '+2347918945668'
        created_at:
          type: string
          format: date-time
          example: '2025-05-09T16:33:21.902Z'
        updated_at:
          type: string
          format: date-time
          example: '2025-05-09T16:33:21.902Z'
        status:
          type: string
          example: active
        address:
          $ref: '#/components/schemas/RegisteredAddress'
        financial_info:
          type: object
          properties:
            account_purpose:
              type: string
              example: business operations
            expected_monthly_income:
              type: string
              example: '5000000.00'
            source_of_funds:
              type: string
              example: business revenue
        business_info:
          type: object
          properties:
            business_name:
              type: string
              example: Example Enterprises
            business_type:
              type: string
              example: Retail
            business_website:
              type: string
              example: https://example.com

````