Business Identity/Account

Creating a business account starts with the KYB process. This is initiated by calling:

POST /api/v1/business-identities
{
  "taxId": "string",
  "phone": "string",
  "email": "user@email.com",
  "address": {
    "street1": "string",
    "street2": "string",
    "postalCode": "string",
    "city": "string",
    "state": "string",
    "country": "string"
      },
  "metadata": "string",
  "businessName": "string",
  "website": "string",
  "owner": {
    "firstName": "string",
    "lastName": "string",
    "middleName": "string",
    "dateOfBirth": "2024-01-11"
  }
}

The business identity has the following statuses:

submitted: the KYB data has been submitted
inReview: the KYB data is in process of being reviewed
needAdditionalInfo: additional information is needed on the business. Customer service will reach out via email to obtain it
accepted: the KYB is approved
rejected: the business is rejected

Once accepted, the account is automatically created and can be retrieved with:

GET /api/v1/business-identities/{id}/account

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "identityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "total": 0
}

Document verification will be done via secure file upload, upload link to be provided at a future date.