Register Wallet Address

POST

/v2.0/payment/crypto/registerWalletAddress

API Overview

Item	Value
API Status	Stable
Current Version	v2.0
Backward Compatibility	Yes
Applicable Environment	Production
Applicable User Roles	PSP and Direct Client

Description
Register Wallet Address

Request

Authorization

Body Params application/json

Example

{
    "participantCode": "B0100106",
    "label": "Ethereum Main Wallet",
    "description": "Primary ETH wallet for trading and deposits",
    "blockchain": "ETH",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb5",
    "isOwner": true,
    "walletType": 1,
    "platformName": "MetaMask",
    "platformUserId": "user_metamask_12345",
    "ownerInfo": {
        "ownerType": 2,
        "details": {
            "corporateName": "TechGlobal Inc.",
            "businessRegistrationNumber": "REG987654321",
            "dateOfIncorporation": "2015-03-10",
            "registeredOrBusinessAddress": {
                "country": "US",
                "state": "New Hampshire",
                "city": "Manchester",
                "postcode": "03101",
                "addressLine1": "1000 Elm Street",
                "addressLine2": "Suite 300"
            }
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2.0/payment/crypto/registerWalletAddress' \
--header 'Content-Type: application/json' \
--data-raw '{
    "participantCode": "B0100106",
    "label": "Ethereum Main Wallet",
    "description": "Primary ETH wallet for trading and deposits",
    "blockchain": "ETH",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb5",
    "isOwner": true,
    "walletType": 1,
    "platformName": "MetaMask",
    "platformUserId": "user_metamask_12345",
    "ownerInfo": {
        "ownerType": 2,
        "details": {
            "corporateName": "TechGlobal Inc.",
            "businessRegistrationNumber": "REG987654321",
            "dateOfIncorporation": "2015-03-10",
            "registeredOrBusinessAddress": {
                "country": "US",
                "state": "New Hampshire",
                "city": "Manchester",
                "postcode": "03101",
                "addressLine1": "1000 Elm Street",
                "addressLine2": "Suite 300"
            }
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "label": "Ethereum Deposit Wallet",
        "description": "External ETH wallet for receiving deposits",
        "blockchain": "ETH",
        "walletAddress": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
        "isOwner": false,
        "walletType": 2,
        "platformName": "Binance",
        "platformUserId": "user_binance_12345",
        "ownerInfo": {
            "ownerType": 1,
            "details": {
                "name": "John Smith",
                "DOB": "1980-05-15",
                "identityNumber": "ID123456789",
                "residentialAddress": {
                    "country": "US",
                    "state": "Ohio",
                    "city": "Columbus",
                    "postcode": "43215",
                    "addressLine1": "123 High Street",
                    "addressLine2": "Apt 4B"
                }
            }
        }
    }
}

Modified at 2026-04-15 03:56:48

Crypto Deposit Webhook

Remove Wallet Address