Sign in

v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB
Account Center

Create SubAccount

This endpoint allows you to create sub-accounts under one of the following supported business lines:

  • ACQUIRING
  • BANKING
  • ISSUING

Each sub-account must be classified as either a COMPANY or an INDIVIDUAL entity.

Once the sub-account is created, it must pass review and be activated before it can be used.

For sub-accounts of type COMPANY, additional documents are typically required to complete onboarding. Please use the Get Additional Documents endpoint to retrieve the list of required and optional documents for your scenario.

post/v1/accounts/create_accounts

Request body

OR

Example request

{
  "entity_type": "COMPANY",
  "nickname": "MyTechCorp",
  "individual_info": {
    "first_name_english": "Zhang",
    "last_name_english": "Wei",
    "name_in_other_language": "张伟",
    "nationality": "SG",
    "tax_number": "440300074445",
    "phone_number": "+12025550123",
    "email_address": "admin@example.com",
    "date_of_birth": "1980-01-01",
    "gender": "MALE",
    "country_or_territory": "SG",
    "street_address": "123 Orchard Road",
    "apartment_suite_or_floor": "Suite 88, Level 10",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "238888",
    "employment_status": "Employed",
    "industry": "Information Technology/IT",
    "job_title": "Business and administration professionals",
    "company_name": "Acme Corp.",
    "annual_income": "85000"
  },
  "identity_verification": {
    "identification_type": "PASSPORT",
    "identification_value": "E12345678",
    "face_docs": [
      "b3d9d2d5-4c12-4946-a09d-953e82sed2b0"
    ]
  },
  "expected_activity": {
    "other_purpose": "freelance payment collection",
    "banking_countries": [
      "SG"
    ],
    "banking_currencies": [
      "SGD"
    ],
    "internationally": 1,
    "turnover_monthly": "TM001",
    "turnover_monthly_currency": "USD"
  },
  "proof_documents": {
    "other_proof": [
      "b3d9d2d5-4c12-4946-a09d-953e82sed2b0"
    ]
  },
  "tos_acceptance": {
    "ip": "192.168.1.1",
    "date": "2025-07-17T08:00:00Z",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36",
    "tos_agreement": 1
  }
}

Response

Account creation successfully.

account_idstring required

A unique identifier of the account.

short_reference_idstring required

The short reference ID of the account.

statusstring required

Status of the account. One of the following:

  • ACTIVE - The account has been activated.
  • PROCESSING - The account is currently undergoing review and processing.
  • INACTIVE - The account temporarily inactive
  • CLOSED - The account has been closed.
verification_status'VERIFIED' | 'UNDER_REVIEW' | 'ACTION_REQUIRED' required

The KYC verification outcome for the cardholder associated with this card creation request.

  • VERIFIED - The cardholder's identity has been verified.
  • UNDER_REVIEW - AML or KYC review is in progress.
  • ACTION_REQUIRED - The cardholder must complete an action (such as Sumsub IDV) before the card can be activated.

Example response

{
  "account_id": "f5bb6498-552e-40a5-b14b-616aa04ac1c1",
  "short_reference_id": "P220406-LLCVLRM",
  "status": "PROCESSING",
  "verification_status": "UNDER_REVIEW"
}