HK request examples

To onboard your entity, you can call the Onboard Corporate Customer API. For an example call that you can customize with your information, see:

Sole traders

{
    "region": "HK",
    "businessDetails": {
        "businessName": "Jacky Chan Kitchen Utensils",
        "businessRegistrationNumber": "92238740598",
        "businessType": "SOLE_TRADER",
        "tradeName": "Jacky Steels & Bowls",
        "website": "www.jackySteelsNBowls.com",
        "legalDetails": {
            "registeredCountry": "HK",
            "registeredDate": "2021-08-10"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "Rm 1301 13/F",
                "addressLine2": "Cre Building 303",
                "city": "Wan Chai District",
                "state": "Hong Kong",
                "country": "HK",
                "postcode": "2055"
            }
        },
        "bankAccountDetails": {
            "accountName": "Hong Kong Company",
            "bankName": "DBS",
            "accountNumber": "123456",
            "currency": "HKD",
            "routingType": "SWIFT",
            "routingValue": "DHBKHKHH"
        },
        "documentDetails": [
            {
                "documentType": "LOA",
                "documentNumber": "N118668(E)",
                "document": [
                    {
                        "fileName": "LOA",
                        "fileType": "png",
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                    }
                ]
            },
            {
                "documentType": "BUSINESS_REGISTRATION_DOC",
                "documentNumber": "2348729383",
                "document": [
                    {
                        "fileName": "BRD001.pdf",
                        "fileType": "png",
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                    }
                ]
            }
        ],
        "stakeholders": [
            {
                "stakeholderDetails": {
                    "kycMode": "MANUAL_KYC",
                    "firstName": "Jacky",
                    "middleName": "J",
                    "lastName": "Chan",
                    "dateOfBirth": "1947-02-15",
                    "nationality": "HK",
                    "address": {
                        "addressLine1": "221 Sai Yeung",
                        "addressLine2": "Choi St N",
                        "city": "Sham Shui Po District",
                        "state": "Hong Kong",
                        "country": "HK",
                        "postcode": "2002"
                    },
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR"
                        }
                    ],
                    "documentDetails": [
                        {
                            "documentType": "NATIONAL_ID",
                            "documentNumber": "C668668E",
							"documentIssuanceCountry": "HK",
                            "document": [
                                {
                                    "fileName": "HKId",
                                    "fileType": "png",
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX///// <base 64 encoding>"
                                }
                            ]
                        }
                    ]
                }
            }
        ],
        "applicantDetails": {
            "kycMode": "E_DOC_VERIFY",
            "firstName": "Johnny",
            "middleName": "J",
            "lastName": "English",
            "dateOfBirth": "1967-02-15",
            "nationality": "HK",
            "professionalDetails": [
                {
                    "position": "SIGNATORY"
                }
            ],
            "address": {
                "addressLine1": "Causeway Rd",
                "addressLine2": "Causeway Bay",
                "city": "Wan Chai District",
                "state": "Hong Kong",
                "country": "HK",
                "postcode": "2002"
            },
			"documentDetails": [
                        {
                            "documentType": "NATIONAL_ID",
                            "documentNumber": "HK686634A",
							"documentIssuanceCountry": "HK",
                            "document": [
                                {
                                    "fileName": "HKId",
                                    "fileType": "png",
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX///// <base 64 encoding>"
                                }
                            ]
                        }
                    ],
            "contactDetails": {
                "countryCode": "HK",
                "contactNo": "303351617013",
                "email": "[email protected]"
            }
        },
        "additionalInfo": {
            "isSameBusinessAddress": "Yes"
        }
    },
    "riskAssessmentInfo": {
        "totalEmployees": "EM004",
        "annualTurnover": "HK001",
        "countryOfOperation": [
            "HK",
            "IN"
        ],
        "industrySector": "IS010",
        "intendedUseOfAccount": "IU007",
		 "transactionCountries":[
          "HK",
          "US",
          "CA"
        ]
    },
    "tags": [
        {
            "key": "Tag 1",
            "value": "Tag 1 HK"
        },
        {
            "key": "Tag 2",
            "value": "Tag 2 HK"
        }
    ]
}

Private companies

{
    "region": "HK",
    "businessDetails": {
        "businessName": "Hachiko Incorporation",
        "businessRegistrationNumber": "123358360598",
        "businessType": "PRIVATE_COMPANY",
        "tradeName": "Hachiko Inc.",
        "website": "www.hachiko.com",
        "legalDetails": {
            "registeredCountry": "HK",
            "registeredDate": "2021-08-10"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "Rm 1301 13/F",
                "addressLine2": "Cre Building 303",
                "city": "Wan Chai District",
                "state": "Hong Kong",
                "country": "HK",
                "postcode": "2055"
            }
        },
        "bankAccountDetails": {
            "accountName": "Hong Kong Company",
            "bankName": "DBS",
            "accountNumber": "123456",
            "currency": "HKD",
            "routingType": "SWIFT",
            "routingValue": "DHBKHKHH"
        },
        "stakeholders": [
            {
                "stakeholderDetails": {
                    "kycMode": "MANUAL_KYC",
                    "firstName": "Mark",
                    "middleName": "J",
                    "lastName": "Cary",
                    "dateOfBirth": "1947-02-15",
                    "nationality": "HK",
                    "address": {
                        "addressLine1": "221 Sai Yeung",
                        "addressLine2": "Choi St N",
                        "city": "Sham Shui Po District",
                        "state": "Hong Kong",
                        "country": "HK",
                        "postcode": "2002"
                    },
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR"
                        }
                    ],
                    "documentDetails": [
                        {
                            "documentType": "NATIONAL_ID",
                            "documentNumber": "C668668E",
                            "documentIssuanceCountry": "HK",
                            "document": [
                                {
                                    "fileName": "HKId",
                                    "fileType": "png",
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                                }
                            ]
                        }
                    ]
                }
            },
            {
                "businessPartner": {
                    "businessEntityType": "UBO",
                    "businessName": "TeleHK LTD",
                    "sharePercentage": "60.00",
                    "businessRegistrationNumber": "987600001",
                    "legalDetails": {
                        "registeredCountry": "HK"
                    }
                }
            }
        ],
        "applicantDetails": {
            "kycMode": "E_DOC_VERIFY",
            "firstName": "John",
            "middleName": "Johnny",
            "lastName": "Dary",
            "dateOfBirth": "1967-02-15",
            "nationality": "HK",
            "professionalDetails": [
                {
                    "position": "SIGNATORY"
                }
            ],
            "address": {
                "addressLine1": "Causeway Rd",
                "addressLine2": "Causeway Bay",
                "city": "Wan Chai District",
                "state": "Hong Kong",
                "country": "HK",
                "postcode": "2002"
            },
            "contactDetails": {
                "countryCode": "HK",
                "contactNo": "303351617013",
                "email": "[email protected]"
            },
            "documentDetails": [
                {
                    "documentType": "NATIONAL_ID",
                    "documentNumber": "H23424214",
                    "documentIssuanceCountry": "HK"
                }
            ]
        },
        "additionalInfo": {
            "isSameBusinessAddress": "Yes"
        }
    },
    "riskAssessmentInfo": {
        "totalEmployees": "EM004",
        "annualTurnover": "HK005",
        "countryOfOperation": [
            "HK",
            "IN"
        ],
        "transactionCountries": [
            "HK",
            "US",
            "CA"
        ],
        "industrySector": "IS010",
        "intendedUseOfAccount": "IU007"
    },
    "tags": [
        {
            "key": "Tag 1",
            "value": "Tag 1 HK"
        },
        {
            "key": "Tag 2",
            "value": "Tag 2 HK"
        }
    ]
}

Limited partnerships

{
    "region": "HK",
    "businessDetails": {
        "businessName": "Mary Kitchens Partnership",
        "businessRegistrationNumber": "19238740598",
        "businessType": "LIMITED_PARTNERSHIP",
        "tradeName": "Mary Kitchens",
        "website": "www.marykitchens.com",
        "legalDetails": {
            "registeredCountry": "HK",
            "registeredDate": "2021-08-10"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "Rm 1301 13/F",
                "addressLine2": "Cre Building 303",
                "city": "Wan Chai District",
                "state": "Hong Kong",
                "country": "HK",
                "postcode": "2055"
            }
        },
        "bankAccountDetails": {
            "accountName": "Hong Kong Company",
            "bankName": "DBS",
            "accountNumber": "123456",
            "currency": "HKD",
            "routingType": "SWIFT",
            "routingValue": "DHBKHKHH"
        },
        "documentDetails": [
            {
                "documentType": "NAR1",
                "documentNumber": "N118668(E)",
                "document": [
                    {
                        "fileName": "NAR1",
                        "fileType": "png",
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                    }
                ]
            },
            {
                "documentType": "LOA",
                "documentNumber": "N118668(E)",
                "document": [
                    {
                        "fileName": "LOA",
                        "fileType": "png",
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                    }
                ]
            },
            {
                "documentType": "PARTNERSHIP_DEED",
                "documentNumber": "2348729383",
                "document": [
                    {
                        "fileName": "PD001",
                        "fileType": "png",
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                    }
                ]
            }
        ],
        "stakeholders": [
            {
                "stakeholderDetails": {
                    "kycMode": "MANUAL_KYC",
                    "firstName": "Mary",
                    "middleName": "J",
                    "lastName": "Campbell",
                    "dateOfBirth": "1947-02-15",
                    "nationality": "HK",
                    "address": {
                        "addressLine1": "221 Sai Yeung",
                        "addressLine2": "Choi St N",
                        "city": "Sham Shui Po District",
                        "state": "Hong Kong",
                        "country": "HK",
                        "postcode": "2002"
                    },
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR"
                        }
                    ],
                    "documentDetails": [
                        {
                            "documentType": "NATIONAL_ID",
                            "documentNumber": "C668668E",
                            "documentIssuanceCountry": "HK",
                            "document": [
                                {
                                    "fileName": "HKId",
                                    "fileType": "png",
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                                }
                            ]
                        }
                    ]
                }
            },
            {
                "businessPartner": {
                    "businessEntityType": "UBO",
                    "businessName": "Kitchens of Hongkong",
                    "sharePercentage": "60",
                    "businessRegistrationNumber": "987600001",
                    "legalDetails": {
                        "registeredCountry": "HK"
                    }
                }
            }
        ],
        "applicantDetails": {
            "kycMode": "E_DOC_VERIFY",
            "firstName": "Jack",
            "middleName": "J",
            "lastName": "Brown",
            "dateOfBirth": "1967-02-15",
            "nationality": "HK",
            "professionalDetails": [
                {
                    "position": "SIGNATORY"
                }
            ],
            "address": {
                "addressLine1": "Causeway Rd",
                "addressLine2": "Causeway Bay",
                "city": "Wan Chai District",
                "state": "Hong Kong",
                "country": "HK",
                "postcode": "2002"
            },
            "contactDetails": {
                "countryCode": "HK",
                "contactNo": "303351617013",
                "email": "[email protected]"
            },
            "documentDetails": [
                {
                    "documentType": "NATIONAL_ID",
                    "documentNumber": "H23424214",
                    "documentIssuanceCountry": "HK"
                }
            ]
        },
        "additionalInfo": {
            "isSameBusinessAddress": "Yes"
        }
    },
    "riskAssessmentInfo": {
        "totalEmployees": "EM004",
        "annualTurnover": "HK002",
        "countryOfOperation": [
            "HK",
            "IN"
        ],
        "transactionCountries": [
            "HK",
            "US",
            "CA"
        ],
        "industrySector": "IS010",
        "intendedUseOfAccount": "IU007"
    },
    "tags": [
        {
            "key": "Tag 1",
            "value": "Tag 1 HK"
        },
        {
            "key": "Tag 2",
            "value": "Tag 2 HK"
        }
    ]
}