Create Merchant

POST

/v2.0/crm/addressBook/createMerchant

Creates a merchant (INDIVIDUAL or CORPORATE) and submits it for KYC/KYB review.

Tier structure

Tier 1/2: corporationDetails (or personalDetails for individual) only. As of v2.1, natureOfBusiness (and optional otherNatureOfBusiness) can also be submitted within additionalCorporationDetails -- note that natureOfBusiness is NOT required for tier 1/2.

Tier 3: sourceOfWealth becomes required in addition to tier 1/2 fields.

Tier 1/2 + 3: these two tiers are currently open for natureOfBusiness submission.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "applicationType": 2,
    "merchantDetails": {
        "personalDetails": {
            "firstName": "John",
            "middleName": "Michael",
            "lastName": "Doe",
            "dateOfBirth": "1985-06-15",
            "nationality": "US",
            "residentialAddress": {
                "country": "US",
                "state": "Arkansas",
                "city": "Little Rock",
                "postcode": "02162",
                "addressLine1": "123 Main Street",
                "addressLine2": "Apt 4B"
            },
            "contactNumber": {
                "countryCode": "86",
                "phoneNumber": "041184807040"
            },
            "email": "john.doe@example.com",
            "taxResidency": "US"
        },
        "additionalPersonalDetails": {
            "occupation": "Software Engineer",
            "purposesOfAccountOpening": [
                "Sell Crypto"
            ],
            "sourceOfFunds": [
                "Sale of Assets"
            ],
            "sourceOfWealth": [
                "Investments or Trading"
            ]
        },
        "supportingDocuments": [
            {
                "type": 2,
                "fileId": "FILE_PASSPORT_US_123456"
            }
        ]
    },
    "acceptedTnC": [
        "X101"
    ],
    "clientReference": "REF202604150003"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v2.0/crm/addressBook/createMerchant' \
--header 'Content-Type: application/json' \
--data-raw '{
    "applicationType": 2,
    "merchantDetails": {
        "personalDetails": {
            "firstName": "John",
            "middleName": "Michael",
            "lastName": "Doe",
            "dateOfBirth": "1985-06-15",
            "nationality": "US",
            "residentialAddress": {
                "country": "US",
                "state": "Arkansas",
                "city": "Little Rock",
                "postcode": "02162",
                "addressLine1": "123 Main Street",
                "addressLine2": "Apt 4B"
            },
            "contactNumber": {
                "countryCode": "86",
                "phoneNumber": "041184807040"
            },
            "email": "john.doe@example.com",
            "taxResidency": "US"
        },
        "additionalPersonalDetails": {
            "occupation": "Software Engineer",
            "purposesOfAccountOpening": [
                "Sell Crypto"
            ],
            "sourceOfFunds": [
                "Sale of Assets"
            ],
            "sourceOfWealth": [
                "Investments or Trading"
            ]
        },
        "supportingDocuments": [
            {
                "type": 2,
                "fileId": "FILE_PASSPORT_US_123456"
            }
        ]
    },
    "acceptedTnC": [
        "X101"
    ],
    "clientReference": "REF202604150003"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "code": 200,
    "msg": "OK",
    "traceId": null,
    "data": {
        "applicationId": "2078702830650900482",
        "status": 1,
        "createdAt": 1784436348000,
        "merchantInfo": {
            "applicationType": 1,
            "clientReference": "cwm-1784436345",
            "merchantDetails": {
                "personalDetails": {
                    "firstName": "Test",
                    "middleName": null,
                    "lastName": "Merchant",
                    "dateOfBirth": "1990-01-01",
                    "nationality": "SG",
                    "residentialAddress": {
                        "addressLine1": "1 Test St",
                        "addressLine2": null,
                        "city": "Singapore",
                        "country": "SG",
                        "postcode": "123456",
                        "state": null
                    },
                    "contactNumber": {
                        "countryCode": "65",
                        "phoneNumber": "91234567"
                    },
                    "email": "cwtest@example.com",
                    "taxResidency": "SG"
                },
                "supportingDocuments": [
                    {
                        "type": 1,
                        "fileId": "a02351db-3d50-4534-b947-735d40ad1e80"
                    }
                ]
            },
            "participantCode": "A0104983",
            "acceptedTnC": null,
            "sourceIp": null
        }
    }
}

Modified at 2026-07-23 07:53:26

Confirm Merchant Activation

Get Merchant