Submit business KYB

1

Check if a business user is allowed to submit KYB

We must check the business user's KYB submission status to see when the KYB entry points in the mobile or web app are shown. Otherwise, it should be hidden from display.

A user can only send a KYB submission for verification if their KYB status is:

• not_submitted - the user has never submitted a KYB for verification

Call Get Business User KYB (GET /businesses/authentications/documents) to get the KYB status of the business.

Get the Business User KYB request

 
curl --location 'https://{{identity_base_url}}/{{program_code}}/v1/businesses/authentications/documents' \
--header 'X-Auth-User-ID: {{business_user_id}}' \
--header 'Authorization: ••••••'

Get the Business User KYB response

 
{
    "count": "n/a",
    "status": "not_submitted"
}

2

Collect and upload the required KYB business and supplemental documents

Business documents that can certify the validity and authenticity of your business profile are required. These can include certificates of incumbency, constitution documents, etc.

Connected parties and beneficial owners are individuals or entities with a material controlling interest in the business. These include, but are not limited to, any director, partner, or person with executive authority.

Call Create KYB (POST /businesses/authentications/documents) to submit/upload the required documents to verify a business. This method only allows for the upload of a single document. For multiple documents, this API should be called for the upload of each document.

Document upload restrictions:

• File format: PNG, JPEG, PDF
• File size: maximum 8MB per file
• Number of files: maximum 50 files

Create KYB-required field enumerations:

• document_type allowed values are listed in the Business Document Types Enumeration (GET /users/enumerations/business_document_types).
• kyb_type allowed values are listed in the KYC Types Enumeration (GET /users/enumerations/kyc_types).

For more details on each supported business document, you can check the Supported KYB documents section.

*These enumerations are all part of the Identity API category; you can access them by using the {{identity_base_url}}.

Create KYB request

 
curl --location 'https://{{identity_base_url}}/{{program_code}}/v1/businesses/authentications/documents' \
--header 'X-Auth-User-ID: {{business_user_id}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: ••••••' \
--data-urlencode 'data=<base64_encoded_image> ' \
--data-urlencode 'document_type=<document_type>' \
--data-urlencode 'kyb_type=MM_DOCUMENT_UPLOAD'

Create KYB response

 
{
    "documents": [
        {
            "document_id": "",
            "document_type": "board_resolution",
            "link": "https://storage.uat.matchmove-beta.com/api/v1/files/{{program_code}}>/kyc/download/2uQsu5nr1eRfabOqYxNMZgJpoOc.jpg",
            "kyb_type": "MM_DOCUMENT_UPLOAD"
        }
    ],
    "count": 1,
    "status": "pending",
    "sub_status": "pending registration submission"
}

3

Confirm all uploads and submit KYB for approval

Once all the required documents have been uploaded, the partner must confirm and finalize KYB for submission. This invokes the KYB verification process with the MatchMove Compliance team.

Call Confirm KYB (PUT /business/authentications/documents) to finalize the uploaded documents and queue the submission for KYB approval.

Confirm KYB request

 
curl --location --request PUT 'https://{{identity_base_url}}/{{program_code}}/v1/business/authentications/documents' \
--header 'X-Auth-User-ID: {{user_id}}' \
--header 'Authorization: ••••••'

Confirm KYB response

 
{
    "count": 1,
    "status": "submitted"
}