Share KYB/KYC Info For Sub User

POST

/v1/kyb/share

Purpose:
To allow a business to securely share its corporate client's KYB (Know Your Business) or KYC (Know Your Customer) data with Damoon before initiating any transactions.

What this endpoint does:

Receives sub-user's KYB data from the business and stores it for compliance checks. This is the first step in onboarding a corporate client for any financial or crypto-fiat service.

Keynotes:

Must be completed before any transactions can be initiated.

requestId is used for traceability and auditing.

subUserId is your corporate user's ID assigned for traceability.

Request

Body Params application/json

Examples

Example 1BRL individualBRL corporate

{
    "jurisdiction": "AE",
    "companyName": "Binance FZE Trading LLC",
    "tradingName": "Binance FZE",
    "companyRegistrationNumber": "IC2021-987654",
    "legalEntityType": "Limited Liability Company",
    "businessEmailAddress": "compliance@binance-fze.example",
    "registeredOfficeAddress": "Level 14, One Central, Dubai World Trade Centre, Dubai, UAE",
    "businessAddress": "Unit 1203, DIFC Gate Avenue, Dubai, UAE",
    "dateOfIncorporation": "2021-03-15",
    "mainBusinessActivities": "Facility Management",
    "locationsOfBusinessOperations": "UAE, Nigeria, Mexico",
    "cryptoAddress": "0x8aB3cD49E0F1a2B3c4D5E6f7A8B9c0D1e2F3A4B5",
    "expectedMonthlyTradingVolume": "USD 5,000,000 - 10,000,000",
    "listOfUltimateBeneficialOwnersUboName": [
        "Alice Chen",
        "Michael Rivera"
    ],
    "listOfDirectorsName": [
        "Grace Liu",
        "David Patel",
        "Sofia Martins"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Example 1BRL individualBRL corporate

curl --location --request POST '/v1/kyb/share' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jurisdiction": "AE",
    "companyName": "Binance FZE Trading LLC",
    "tradingName": "Binance FZE",
    "companyRegistrationNumber": "IC2021-987654",
    "legalEntityType": "Limited Liability Company",
    "businessEmailAddress": "compliance@binance-fze.example",
    "registeredOfficeAddress": "Level 14, One Central, Dubai World Trade Centre, Dubai, UAE",
    "businessAddress": "Unit 1203, DIFC Gate Avenue, Dubai, UAE",
    "dateOfIncorporation": "2021-03-15",
    "mainBusinessActivities": "Facility Management",
    "locationsOfBusinessOperations": "UAE, Nigeria, Mexico",
    "cryptoAddress": "0x8aB3cD49E0F1a2B3c4D5E6f7A8B9c0D1e2F3A4B5",
    "expectedMonthlyTradingVolume": "USD 5,000,000 - 10,000,000",
    "listOfUltimateBeneficialOwnersUboName": [
        "Alice Chen",
        "Michael Rivera"
    ],
    "listOfDirectorsName": [
        "Grace Liu",
        "David Patel",
        "Sofia Martins"
    ]
}'

Responses

🟢200OK

application/json

Body

Example

{
    "status": 200,
    "code": null,
    "msg": "OK",
    "traceId": "Auto:bf288b9af2e04dff88e943f2dcaf2b03",
    "data": {
        "success": "true",
        "subUserId": "202610001",
        "externalUserId": "user-001"
    }
}

BRL Pay-in Business Integration Guide

Get KYB Sub User Status