Create Merchant（new）

Designing

POST

/v1.0/crm/addressBook/createMerchant

修改枚举值描述，不涉及代码修改
0114
corporateDetails-authSignFullName 分为first middle和last name
additionalCorporationDetails - contactPerson-name分为first middle和last name
additionalCorporationDetails - ubos-fullname分为first middle和last name

Request

Authorization

Body Params application/json

Example

{
    "applicationType": 1,
    "clientReference": "string",
    "merchantDetails": {
        "personalDetails": {
            "firstName": "string",
            "middleName": "string",
            "lastName": "string",
            "dateOfBirth": "string",
            "nationality": "string",
            "residentialAddress": {
                "country": "string",
                "state": "string",
                "city": "string",
                "postcode": "string",
                "addressLine1": "string",
                "addressLine2": "string"
            },
            "taxResidency": "string"
        },
        "additionalPersonalDetails": {
            "phoneNumber": "string",
            "emailAddress": "string",
            "employerName": "string",
            "jobDesignation": "string",
            "occupation": "string",
            "industry": 1,
            "purposes": [
                "Buy Crypto"
            ],
            "sourceOfFunds": [
                "Cryptocurrency Mining"
            ],
            "sourceOfWealth": [
                "Cryptocurrency Mining"
            ]
        },
        "supportingDocuments": [
            {
                "type": 1,
                "fileId": "string"
            }
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1.0/crm/addressBook/createMerchant' \
--header 'Content-Type: application/json' \
--data-raw '{
    "applicationType": 1,
    "clientReference": "string",
    "merchantDetails": {
        "personalDetails": {
            "firstName": "string",
            "middleName": "string",
            "lastName": "string",
            "dateOfBirth": "string",
            "nationality": "string",
            "residentialAddress": {
                "country": "string",
                "state": "string",
                "city": "string",
                "postcode": "string",
                "addressLine1": "string",
                "addressLine2": "string"
            },
            "taxResidency": "string"
        },
        "additionalPersonalDetails": {
            "phoneNumber": "string",
            "emailAddress": "string",
            "employerName": "string",
            "jobDesignation": "string",
            "occupation": "string",
            "industry": 1,
            "purposes": [
                "Buy Crypto"
            ],
            "sourceOfFunds": [
                "Cryptocurrency Mining"
            ],
            "sourceOfWealth": [
                "Cryptocurrency Mining"
            ]
        },
        "supportingDocuments": [
            {
                "type": 1,
                "fileId": "string"
            }
        ]
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "100",
    "msg": "success",
    "data": {
        "applicationId": "55",
        "merchantDetails": {
            "participantCode": "B000010",
            "applicationType": 1,
            "clientReference": "sint",
            "merchantDetails": {
                "personalDetails": {
                    "name": "Josh Hartmann",
                    "dateOfBirth": "2025-03-29",
                    "nationality": "ipsum tempor ad",
                    "residentialAddress": {
                        "country": "non dolor",
                        "state": "Indiana",
                        "city": "Lefflerport",
                        "postcode": "29552",
                        "addressLine1": "elit cillum",
                        "addressLine2": "dolor esse velit minim"
                    },
                    "jobDesignation": "pariatur quis nulla occaecat"
                },
                "additionalPersonalDetails": {
                    "phoneNumber": "(696) 599-5440",
                    "emailAddress": "Wilburn.Schuster@gmail.com",
                    "employerName": "Kim Boyer",
                    "occupation": "commodo Ut minim incididunt",
                    "industry": 18,
                    "purposes": [
                        "Sell Crypto",
                        "Wealth Products (fiat)"
                    ],
                    "sourceOfFunds": [
                        "Other"
                    ],
                    "sourceOfWealth": [
                        "Other",
                        "Business Loan",
                        "Sale of Assets"
                    ]
                }
            },
            "requiredDocuments": [
                "nulla sit",
                "aliquip et dolor non dolor",
                "aliquip"
            ]
        },
        "status": 3,
        "createAt": 1731668221316
    }
}

Modified at 2026-01-29 01:57:40

Create Merchant

Update Merchant