Merchant SignUp

POST

/v1/channel/merchant/signUp

Enables partners to register and create a merchant account.

Request

Body Params application/json

Example

{
    "name": "Hong Kong Technology Limited",
    "type": "ENTERPRISE",
    "certType": "COMPANY_REGISTRATION_CERTIFICATE",
    "certNo": "12345678",
    "country": "HK",
    "province": "Hong Kong",
    "city": "Hong Kong",
    "address": "Unit 1234, 12/F, Central Plaza, 18 Harbour Road, Wan Chai",
    "email": "info@hktech.com.hk",
    "mobile": "+85298765432",
    "legals": [
        {
            "name": "CHAN TAI MAN",
            "type": "LEGALPERSON",
            "certType": "HONG_KONG_ID_CARD",
            "certNo": "A123456(7)",
            "country": "HK",
            "province": "Hong Kong",
            "city": "Hong Kong",
            "address": "Flat A, 15/F, Tower 1, Silvercord, 30 Canton Road, Tsim Sha Tsui"
        },
        {
            "name": "WONG SIU MING",
            "type": "UBO",
            "certType": "PASSPORT",
            "certNo": "HK1234567",
            "country": "HK",
            "province": "Hong Kong",
            "city": "Hong Kong",
            "address": "Room 888, 88/F, International Commerce Centre, 1 Austin Road West, Kowloon"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/channel/merchant/signUp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Hong Kong Technology Limited",
    "type": "ENTERPRISE",
    "certType": "COMPANY_REGISTRATION_CERTIFICATE",
    "certNo": "12345678",
    "country": "HK",
    "province": "Hong Kong",
    "city": "Hong Kong",
    "address": "Unit 1234, 12/F, Central Plaza, 18 Harbour Road, Wan Chai",
    "email": "info@hktech.com.hk",
    "mobile": "+85298765432",
    "legals": [
        {
            "name": "CHAN TAI MAN",
            "type": "LEGALPERSON",
            "certType": "HONG_KONG_ID_CARD",
            "certNo": "A123456(7)",
            "country": "HK",
            "province": "Hong Kong",
            "city": "Hong Kong",
            "address": "Flat A, 15/F, Tower 1, Silvercord, 30 Canton Road, Tsim Sha Tsui"
        },
        {
            "name": "WONG SIU MING",
            "type": "UBO",
            "certType": "PASSPORT",
            "certNo": "HK1234567",
            "country": "HK",
            "province": "Hong Kong",
            "city": "Hong Kong",
            "address": "Room 888, 88/F, International Commerce Centre, 1 Austin Road West, Kowloon"
        }
    ]
}'

Responses

🟢200

application/json

Body

Example

{
    "merchantId": "445684d438564efea3b92a8d674d5516",
    "name": "Hong Kong Technology Limited",
    "type": "ENTERPRISE",
    "certType": "COMPANY_REGISTRATION_CERTIFICATE",
    "certNo": "12345678",
    "country": "HK",
    "province": "Hong Kong",
    "city": "Hong Kong",
    "address": "Unit 1234, 12/F, Central Plaza, 18 Harbour Road, Wan Chai",
    "email": "info@hktech.com.hk",
    "mobile": "+85298765432",
    "remark": null,
    "status": "INIT",
    "legals": [
        {
            "name": "CHAN TAI MAN",
            "type": "LEGALPERSON",
            "certType": "HONG_KONG_ID_CARD",
            "certNo": "A123456(7)",
            "country": "HK",
            "province": "Hong Kong",
            "city": "Hong Kong",
            "address": "Flat A, 15/F, Tower 1, Silvercord, 30 Canton Road, Tsim Sha Tsui"
        },
        {
            "name": "WONG SIU MING",
            "type": "UBO",
            "certType": "PASSPORT",
            "certNo": "HK1234567",
            "country": "HK",
            "province": "Hong Kong",
            "city": "Hong Kong",
            "address": "Room 888, 88/F, International Commerce Centre, 1 Austin Road West, Kowloon"
        }
    ]
}

Modified at 2025-12-22 05:37:28

RevenueSharingStatusQueryResponseData

Merchant Query