HK onboarding

Overview

This page contains details about the Hong Kong (HK) Know Your Business (KYB) flows and links to the following sub-pages for a quick reference:

Nium offers Manual KYB flows for customers in Hong Kong.

Manual KYB Flow

The following steps need to be performed for completing an application via Manual KYB.

For Manual KYB, you need to call the Onboard Corporate Customer API directly. In this flow, the entire request body needs to be passed in the Onboard Corporate Customer API.

Applicant KYC

E_DOC_VERIFY and MANUAL_KYC are supported for applicants in HK. E_DOC_VERIFY is the preferred mode of KYC since it reduces the turnaround time. If required, you can use Manual_KYC, however uploading of documents is required for Manual KYC which needs to be sent in businessDetails.applicantDetails.documentDetails. For details, see HK required documents for applicants.

⚠️

CAUTION

The API gateway has a limit of 10 MB for any API request. This makes Upload Document API the preferred way to upload documents since you can upload one document at a time.

E_DOC_VERIFY

As a response to the Onboard Corp Customer API, Nium returns a redirect URL. You need to save this URL and redirect the applicant to the redirectURL. The applicant then lands on the KYC vendor's page, where he can complete the KYC verification by uploading his proof of identity and proof of address documents with a live selfie. After that, applicants are redirected back to your client KYC redirect URL that was configured with Nium.

Redirection can result in the following scenarios, based on the below parameters.

• errorCode
• errorMessage
• isSuccess – This field indicates if the applicant completed the required steps in the vendor’s UI. It doesn't mean KYC is successful.

Based on the scenario, you can implement the next steps as provided in the table above.

Example of a redirect to the client in a successful case

https://www.clientRedirectURL.com/?clientId=NIM1681898211881&caseId=4ff53849-3d30-45c8-af11-

f95c315ce83c&isSucces=true&errorCode=&errorMessage=

Example of a redirect to the client in a failed case

https://www.clientRedirectURL.com/?clientId=NIM1681898211881&caseId=4ff53849-3d30-45c8-af11-

f95c315ce83c&errorCode=R408&errorMessage=redirectURLExpired&isSucces=false

For applicants where the businessDetails.applicantDetails.address.country is US, the applicant's address' state needs to be a valid 2 letter state code. Use the Fetch Corporate Constants API for a set of valid values.

⚠️

CAUTION

There's an expiration time for the redirectURL, so the applicant needs to complete the process soon after submitting the application.

If the URL expires, the applicant is redirected to your configured client KYC redirect URL with an error message. Use the Regenerate KYC URL API to get a new URL with a new expiration time.

Stakeholder KYC

Only MANUAL_KYC is offered for KYC of Individual stakeholders in Hong Kong. Uploading of documents is required for Manual KYC which needs to be sent in businessDetails.stakeholders.stakeholderDetails.documentDetails. For details, see HK required documents for stakeholders.

Bank Account Details

Applicants must submit Bank Account Details of the corporate customer in the businessDetails.bankAccountDetails object . This is required per regulations to enable auto-sweep.

After submission, the status in the response of the Onboard Corporate Customer API is IN_PROGRESS. Nium initiates manual verification and sends the response via webhook. The application can get approved at this stage. Any changes in status is again communicated via webhook. For the next steps based on the response of the webhook, see Webhooks.

Terms and Conditions

You must show customers the Nium terms and conditions configured for your client resource. You can fetch these specific terms and conditions using our Terms And Conditions API.

Customers can only submit the onboarding form once they accept the terms and conditions.

To fetch the Terms And Conditions API:

1. Wait for the Onboarding API to return a customerHashId.
2. Once returned, call our Accept Terms and Conditions API and include the customerHashId.
3. Show the customer the returned terms and conditions and record their acceptance before allowing them to transact.

For more details, see Terms and Conditions.