BPN
  1. KYB
BPN
  • Getting Started
    • Introduction to BPN
    • Key Concepts & Terminology
    • Architecture Overview
  • Onboarding & Prerequisites
    • Product Demo
    • Sandbox & Test Environment
  • Use Case
    • Transfer
    • Vault
    • On/Off Ramp
    • Compliance (Travel Rule Information Submission)
  • API Reference
    • KYB
      • Share KYB Info For Sub User
        POST
      • Get KYB Sub User Status
        GET
    • Account Management
      • add bank account
      • list bank account
      • create virtaul account
      • list virtual account
      • Master VA balance inquiry
      • list virtual account orders
      • refund virtual account order
    • Wallet
      • Get Asset Balance
      • Get Deposit Address
      • Add Deposit Sender
      • Add Withdraw Whitelist
      • Delete Withdraw Whiltelist
      • Request Withdraw
      • Query Transaction History
    • FX
      • fx inquery
    • BPN Transactions
      • get stablecoin quote
      • create stable order
      • get order (single) detail
      • list orders(batch)
    • Reconciliation
  • Webhooks & Event
    • resend fail webhook
      POST
    • KYB Status Notification
      POST
    • Transaction Status Notification
      POST
    • Account Status Notification
      POST
    • Open Virtual Account Status
      POST
    • Deposit Sender Detail Required
      POST
    • virtual account payment status
      POST
  • Appendix
    • Enum
    • Virtual Account(VA) Support List
  • Release Notes & Changelog
    • Version History
  • Schemas
    • Schemas
      • walletBalance
      • walletAddress
      • transactionRecord
  1. KYB

Share KYB Info For Sub User

POST
/v1/kyb/share
Purpose:
To allow a business to securely share its corporate client's KYB (Know Your Business) 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

Responses

🟢200OK
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
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"
    ]
}'
Response Response Example
{
    "status": "200",
    "code": null,
    "msg": null,
    "traceId": "Auto:bf288b9af2e04dff88e943f2dcaf2b03",
    "data": {
        "requestId": "bf288b9af2e04dff88e943f2dcaf2b03",
        "subUserId": "10000111"
    }
}
Modified at 2025-08-26 15:16:25
Previous
Compliance (Travel Rule Information Submission)
Next
Get KYB Sub User Status
Built with