Skip to main content
This guide covers the key steps for implementing KYB on the new USD rail for business users.

Overview

The KYB (Know Your Business) flow for the new USD rail includes enhanced compliance requirements and streamlined document upload processes. Business users must provide comprehensive information about their company and all Ultimate Beneficial Owners.
The new USD rail requires using the updated flow. You must use the new documentation endpoint to upload business documents. Failing to do so will result in a 400 error when submitting the application.

Step 1: Create a Business User

Before providing additional details, you must first create a business user with basic company information. POST /v2/users
curl --request POST \
     --url https://sandbox.hifibridge.com/v2/users \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY' \
     --header 'content-type: application/json' \
     --data '{
  "type": "business",
  "businessName": "Acme Corp",
  "businessType": "c_corporation",
  "businessIndustry": "Technology",
  "registrationNumber": "12345678",
  "incorporationDate": "2000-01-01",
  "registeredAddress": {
    "addressLine1": "456 Business Rd",
    "city": "San Francisco",
    "stateProvinceRegion": "CA",
    "postalCode": "94105",
    "country": "USA"
  },
  "email": "business@acmecorp.com",
  "phone": "+1-555-555-5555",
  "taxIdentificationNumber": "98-7654321",
  "signedAgreementId": "2415fed7-ce1c-4752-a67e-8ed1bb4a1a0d"
}'
Response:
{
  "id": "507bb845-47bd-5509-9514-9e5cfde140be",
  "type": "business",
  "email": "business@acmecorp.com",
  "name": "Acme Corp",
  "wallets": {
    "BUSINESS": {
      "POLYGON": {
        "address": "0x2a932E54e77Aeb698144550d5a493Ea99E20Daa8"
      },
      "ETHEREUM": {
        "address": "0xD1c767eaB34b3Cc2C33a354f6Ff2c20fCB98D3C0"
      }
    }
  }
}

Step 2: Upload KYB Information

After creating the business user, you can provide the additional KYB information required for the USD rail. POST /v2/users/{userId}/kyb
curl --request POST \
     --url https://sandbox.hifibridge.com/v2/users/507bb845-47bd-5509-9514-9e5cfde140be/kyb \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY' \
     --header 'content-type: application/json' \
     --data '{
    "businessDescription": "Software development and consulting services",
    "website": "https://acmecorp.com",
    "businessPurpose": "Technology services and software development",
    "expectedMonthlyVolume": "100000",
    "sourceOfFunds": "Business operations and client payments"
}'

Step 3: Add Ultimate Beneficial Owners (UBOs)

For business users, you must identify and provide information for all Ultimate Beneficial Owners who own 25% or more of the business. POST /v2/users/{userId}/kyb/ubos
curl --request POST \
     --url https://sandbox.hifibridge.com/v2/users/507bb845-47bd-5509-9514-9e5cfde140be/kyb/ubos \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY' \
     --header 'content-type: application/json' \
     --data '[
  {
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane.smith@acmecorp.com",
    "dateOfBirth": "1985-06-15",
    "nationality": "USA",
    "ownershipPercentage": 60,
    "address": {
      "addressLine1": "789 Owner St",
      "city": "San Francisco",
      "stateProvinceRegion": "CA",
      "postalCode": "94102",
      "country": "USA"
    },
    "phone": "+1-555-123-4567"
  },
  {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@acmecorp.com",
    "dateOfBirth": "1980-03-22",
    "nationality": "USA",
    "ownershipPercentage": 40,
    "address": {
      "addressLine1": "321 Partner Ave",
      "city": "San Francisco",
      "stateProvinceRegion": "CA",
      "postalCode": "94103",
      "country": "USA"
    },
    "phone": "+1-555-987-6543"
  }
]'

Step 4: Upload Documentation

Business users must upload various documents including business registration, formation documents, and UBO identity documents.

Upload Business Documents

POST /v2/files
curl --request POST \
     --url https://sandbox.hifibridge.com/v2/files \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY' \
     --header 'content-type: multipart/form-data' \
     --form file='@articles_of_incorporation.pdf'

Add Business Documents

POST /v2/users/{userId}/kyb/documents
curl --request POST \
     --url https://sandbox.hifibridge.com/v2/users/507bb845-47bd-5509-9514-9e5cfde140be/kyb/documents \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY' \
     --header 'content-type: application/json' \
     --data '[
  {
    "type": "ARTICLES_OF_INCORPORATION",
    "fileId": "file_business_doc_123",
    "issuedCountry": "USA"
  },
  {
    "type": "BUSINESS_LICENSE",
    "fileId": "file_business_license_456",
    "issuedCountry": "USA"
  }
]'

Upload UBO Documents

For each UBO, you must upload their identity documents: POST /v2/users/{userId}/kyb/ubos/{uboId}/documents
curl --request POST \
     --url https://sandbox.hifibridge.com/v2/users/507bb845-47bd-5509-9514-9e5cfde140be/kyb/ubos/ubo_123/documents \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY' \
     --header 'content-type: application/json' \
     --data '[
  {
    "type": "DRIVERS",
    "subType": "FRONT_SIDE",
    "fileId": "file_ubo_doc_789",
    "issuedCountry": "USA"
  },
  {
    "type": "DRIVERS",
    "subType": "BACK_SIDE",
    "fileId": "file_ubo_doc_790",
    "issuedCountry": "USA"
  }
]'

Step 5: Check KYB Requirements (Optional)

You can use the “Check KYB Requirements” endpoint to verify any missing or invalid information before submitting the KYB application. GET /v2/users/{userId}/kyb/requirements
curl --request GET \
     --url 'https://sandbox.hifibridge.com/v2/users/507bb845-47bd-5509-9514-9e5cfde140be/kyb/requirements?rails=USD' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY'

Step 6: Submit KYB

Once all required information has been submitted, you can now submit the KYB application to our new USD rail! POST /v2/users/{userId}/kyb/submissions
curl --request POST \
     --url https://sandbox.hifibridge.com/v2/users/507bb845-47bd-5509-9514-9e5cfde140be/kyb/submissions \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY' \
     --header 'content-type: application/json' \
     --data '{"rails":"USD"}'
Response:
{
  "USD": {
    "status": "CREATED",
    "message": "Your KYB application has been successfully created. We will review it shortly."
  }
}

Step 7: Retrieve KYB Status

After submitting the KYB application, you can retrieve the latest screening result. GET /v2/users/{userId}/kyb/status
curl --request GET \
     --url 'https://sandbox.hifibridge.com/v2/users/507bb845-47bd-5509-9514-9e5cfde140be/kyb/status?rails=USD' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR-API-KEY'

Required Documents

For comprehensive information about required business documents, please refer to:

Next Steps

🎉 Congratulations! The business user has been successfully onboarded. You can now proceed to:
I