Sandbox
  • Production
  • Sandbox
  1. Merchant Management
Sandbox
  • Production
  • Sandbox
  • API
    • Getting Started
    • Idempotent Requests
    • Webhook
    • Authentication
      • Get Token
    • Merchant Management
      • Create Merchant
        POST
      • Create Merchant(new)
        POST
      • Update Merchant
        POST
      • Update Merchant(new)
        POST
      • Get Merchant
        GET
      • Get Merchant(new)
        GET
      • Merchant Status Webhook
      • Merchant Status Webhook(new)
    • Fiat Payment
      • Bank Account Management
        • Create Fiat Account Application
        • Get Fiat Account Application Status
        • Get Deposit Bank Account
        • Add Bank Account
        • Get Bank Accounts
        • Fiat Account Application Status Webhook
      • Fiat Withdrawal
        • Create Fiat Withdrawal
        • Get Fiat Withdrawal History
        • Get Fiat Withdrawal Detail
        • Get List of Currencies that Supports Same-Name Withdrawal
        • Fiat Withdrawal Webhook
      • Fiat Deposit
        • Get Fiat Deposit Detail
        • Get Fiat Deposit History
        • Fiat Deposit Webhook
    • Crypto Payment
      • Crypto Checkout
        • Create Crypto Checkout
        • Create Crypto Checkout Link
        • Crypto Checkout Wallet Connection
        • Generate POS Payment Request
        • Close Crypto Checkout
        • Get Convertible Cryptos
        • Get Crypto Checkout
        • Get Crypto Checkout Link
        • Get Crypto Checkout Currencies
        • Crypto Checkout Webhook
      • Crypto Deposit
        • Update Crypto Deposit Travel Rule Info
        • Get Crypto Deposit Wallet
        • Get Crypto Deposit Wallet(new)
        • Get Crypto Deposit
        • Get Crypto Deposit History
        • Get Crypto Deposit History(new)
        • Crypto Deposit Webhook (new)
      • Crypto Withdrawal
        • Register Wallet Address
        • Remove Wallet Address
        • Create Crypto Withdrawal
        • Get Wallet Address
        • Get Crypto Withdrawal
        • Get Crypto Withdrawal History
        • Crypto Withdrawal Webhook
        • Get Crypto Withdrawal History (new)
      • Crypto Collection
        • Buyer Management
          • Create Buyer
          • Get Buyer
          • Update Buyer
          • Buyer Status Webhook
        • Create Collection Wallet
        • Update Collection Wallet
        • Get Collection Wallet
        • Get Crypto Collection
        • Crypto Collection Wallet Webhook
        • Crypto Collection Webhook
        • Update Co-KYT status
      • Crypto Refund
        • Create Crypto Refund
        • Confirm Crypto Refund
        • Get Crypto Refund
        • Crypto Refund Webhook
      • Currency & Blockchain
        • Get Supported Blockchains
    • Conversion
      • Create Quotation
      • Create Conversion
      • Get Quotation
      • Get Conversion
      • Conversion Webhook
    • Settlement
      • (Deprecated) Get Settlement Statement
    • Tool
      • Upload File
    • Account Management
      • Get Balance
      • Get Balance (new)
      • Internal Transfer
      • Get Internal Transfer
      • (deprecated) Get Statement
    • VA+POBO(V2)
      • Bank Account Management
        • Get Fiat Account Capabilities
        • Create Fiat Account Request
        • Submit Additional Information for Fiat Account Request
        • Fiat Account Request Status Webhook
        • Fiat Account/Onboarding Full Fields Specification
      • Withdrawal
        • Get Same Name Withdrawal Capabilities
        • Activate Same Name Withdrawal
        • Submit Additional Information for Activating Same Name Withdrawal
        • Activate Same Name Withdrawal Webhook
        • Create Fiat Withdrawal
        • Submit Additional Information for Fiat Withdrawal Request
        • Get Fiat Withdrawal Detail
        • Get Fiat Withdrawal History
        • Fiat Withdrawal Webhook
        • Same Name Payout Full Fields Specification
  1. Merchant Management

Create Merchant

Designing
POST
/v1.0/crm/addressBook/createMerchant
To create a merchant.
The following are list of the supporting document of a CORPORATE and INDIVIDUAL for supportingDocuments:
CORPORATE
DocumentsRemarks
Certificate of Incorporation / BizAcraColored copy
Certificate of Incumbency / NAR1 +BRO / BizAcraColored copy
Ownership Structure Chart (including % holdings) - 2 layers and aboveSigned and dated by Director within last 3 months
Copy of Passport for all UBOsColored copy, more than 6 months validity, Non-colored copy requires CTC
Proof of Address for UBOsDated within the last 3 months
Board ResolutionSigned by one of the directors
Proof of SOF (HIGH RISK and/or PEP)Based on sourceOfFunds E.g. Loan agreement or sale agreement
Proof of Business IncomeDated withtin last 6 months. E.g. Client invoices/ contracts
INDIVIDUAL
DocumentsRemarks
Copy of Identity Card or PassportColored copy, more than 6 months validity, Non-colored copy requires CTC
Proof of Residential AddressE.g. utility bill, bank statement, tenancy agreement, government issued letter - dated within the last 3 months
Proof of SOF (HIGH RISK and/or PEP)Payslip, sale agreement, investment statement - dated within the last 3 months

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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-28 07:03:44
Previous
Get Token
Next
Create Merchant(new)
Built with