Create Merchant

API Overview

Item	Value
API Status	Recommended
Current Version	v2.0
Backward Compatibility	Yes
Applicable Environment	Production
Applicable User Roles	PSP

Description

This is the recommended API for creating a merchant.

Notes

The following are list of the supporting document of a CORPORATE and INDIVIDUAL for supportingDocuments:

CORPORATE

Document	Remarks
Certificate of Incorporation	Colored copy
Certificate of Incumbency / Annual Return	Colored copy
Memorandum and Articles of Association / Constitution	Colored copy, signed copy and dated by one (1) Director on the first page
Shareholders List	E.g. latest Organisation chart (signed and dated), shareholders lists, detailing all effective shareholders of 25% or more
Proof of Business Activity	Client Invoices or Contracts within the last 6 months
Proof of SOW / SOF	E.g. latest financial statement, copy of contact of sale, investment portfolio statement
Proof of Existing Holdings of Funds	E.g. bank statement, screenshots of wallet balance, screenshots of transaction activity
Proof of Passport for all Directors, UBOs and Authorised Signatories	Scanned copy with at least six (6) months validity. Non-colored copy requires CTC
Proof of Residential Address for all Directors, UBOs and Authorised Signatories	Scanned copy, dated within the last three (3) months

INDIVIDUAL

Documents	Remarks
Proof of Passport	Scanned copy with at least six (6) months validity. Non-colored copy requires CTC.
Proof of Residential Address	Scanned copy, dated within the last three (3) months

Request

Authorization

Body Params application/json

Example

{
    "applicationType": 1,
    "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"
            },
            "contactNumber": {
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string",
            "taxResidency": "string"
        },
        "additionalPersonalDetails": {
            "occupation": "string",
            "purposesOfAccountOpening": [
                "Buy Crypto"
            ],
            "sourceOfFunds": [
                "Cryptocurrency Mining"
            ],
            "sourceOfWealth": [
                "Cryptocurrency Mining"
            ]
        },
        "supportingDocuments": [
            {
                "type": 1,
                "fileId": "string"
            }
        ]
    },
    "acceptedTnC": [
        "string"
    ],
    "clientReference": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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
    }
}