Business

Overview

This object is used to onboard a business client onto the platform.
It captures company details, financial information, addresses, and associated individuals (e.g., directors, shareholders, UBOs).

{
  "basic_info": { ... },
  "financial_profile": { ... },
  "addresses": { ... },
  "associated_parties": [ ... ],
  "meta_data": { ... }
}

1. Basic Information

Provide the company’s official details exactly as shown on incorporation documents.

• business_name — Full legal name of the entity.
• business_trade_name — Brand or trading name (optional).
• description — Short description of what the company does.
• entity_type — Type of entity (e.g., PRIVATE_LIMITED, SOLE_PROPRIETORSHIP, LLC).
• website — Official business website.
• email — Business contact email (avoid personal emails).
• phone — Company phone number in E.164 format (e.g., +14155552671).
• incorporation_date — The date the company was legally incorporated.
• country_of_incorporation — ISO Alpha-3 country code of incorporation.
• registration_number — Company or business registration number.
• tax_id — Tax or VAT number if available.

All fields should match the company’s legal documentation (e.g., Certificate of Incorporation).

2. Financial Profile

Describe how the company expects to use the platform and where its funds originate.

• purpose_id — ID representing the company’s reason for using your service (e.g., “cross-border payouts”).
• business_industry_id — ID representing the company’s primary industry.
• monthly_volume — Expected monthly transaction volume in USD.
• source_of_fund_id — ID describing where the company’s funds come from (e.g., SALES_REVENUE, OWNER_CAPITAL).
• third_party_fund_usage — Set to true only if the company processes funds on behalf of others.

For most normal businesses (SaaS, import/export, agencies), third_party_fund_usage should remain false.

3. Addresses

Provide both legal (registered) and physical (operational) addresses.

• is_incorporated_address_same — true if both addresses are identical.
• incorporated_address — The registered company address from incorporation papers.
• physical_address — The address where the company physically operates (if different).

Each address includes:

• street — Building and street name.
• city — City or locality.
• state — State or subdivision (use ISO-3166-2 format if available).
• postal_code — Postal or ZIP code.
• country — ISO Alpha-3 country code.

Avoid P.O. Boxes — use a verifiable street address.

4. Associated Parties

List all individuals who own, control, or manage the business. Each and every individual that has a significant control over the entity has to be registered.

Each object represents one person such as a UBO, Director, or Shareholder.

basic_info

• Full legal name, date of birth, contact info, nationality, and residence.
• tin (Tax Identification Number) is optional but preferred.

address

• The person’s current residential address (should match proof of address).

ownership_info

• designation — Role or title (e.g., CTO, Director).
• percentage_of_ownership — Shareholding percentage.
• relationship_establishment_date — When the person joined or became an owner.

Supporting identity and address documents are uploaded separately through the Associated Party Document API.

5. meta_data

Used for internal tracking and references.

• reference — Developer-defined internal reference for this onboarding record.

Example Payload

{
  "basic_info": {
    "business_name": "Jane Pte Ltd Business",
    "business_trade_name": "Jane",
    "description": "Some text about the company",
    "entity_type": "PRIVATE_LIMITED",
    "website": "https://jane.web",
    "email": "[email protected]",
    "incorporation_date": "2000-01-01",
    "phone": "+6591234567",
    "country_of_incorporation": "SGP",
    "registration_number": "202312345N",
    "tax_id": "TAX-996877"
  },
  "financial_profile": {
    "purpose_id": 10,
    "business_industry_id": 1,
    "monthly_volume": 4000.00,
    "source_of_fund_id": 13,
    "third_party_fund_usage": false
  },
  "addresses": {
    "is_incorporated_address_same": true,
    "incorporated_address": {
      "street": "10 Anson Road #26-04 International Plaza",
      "city": "Singapore",
      "state": "SG-01",
      "postal_code": "079903",
      "country": "SGP"
    },
    "physical_address": {
      "street": "10 Anson Road #26-04 International Plaza",
      "city": "Singapore",
      "state": "SG-01",
      "postal_code": "079903",
      "country": "SGP"
    }
  },
  "associated_parties": [
    {
      "basic_info": {
        "first_name": "John",
        "last_name": "Doe UBO1 c2",
        "dob": "1990-05-10",
        "email": "[email protected]",
        "phone": "+6531284667",
        "country_of_residence": "SGP",
        "nationality": "SGP",
        "tin": "SG-TIN-443566"
      },
      "address": {
        "street": "123 Orchard Road #12-01",
        "city": "Singapore",
        "state": "SG-01",
        "postal_code": "238888",
        "country": "SGP"
      },
      "ownership_info": {
        "designation": "CTO",
        "percentage_of_ownership": 10.00,
        "relationship_establishment_date": "2015-06-01"
      }
    }
  ],
  "meta_data": {
    "reference": "ref-20250910-XYZ"
  }
}

Developer Notes

• Always use ISO Alpha-3 country codes (e.g., SGP, USA, BGD).
• Dropdowns like purpose_id, business_industry_id, and source_of_fund_id must map to predefined internal lists.
• Include all significant UBOs/shareholders (≥10%) + individuals having major control over the company.
• Dates should always follow YYYY-MM-DD format.
• Document uploads (IDs, certificates, proofs) are handled via separate document attachment endpoints.