WalletManagementAPI

1. 文件上传 (FileUpload)

接口概述 提交底层客户资料前,需使用该接口上传企业相关的文件。 请求参数

参数名	类型	是否必填	描述
mediaType	string	是	枚举: jpeg / jpg / png / pdf / gif
mediaFile	file	是	上传的文件,不超过20M

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果。如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	string	校验成功时返回,返回数据为文件的key

响应示例

{
	"code":1,
	"message":"success",
	"data":"123876789124.png"
}

2. 提交底层客户企业资料 (CreateProfileApplication)

接口概述 提交底层客户的资料。首次提交底层客户资料可通过该接口提交,或者提交底层客户资料被RD审核拒绝后可通过该接口重新提交申请。 请求参数

参数名	类型	是否必填	描述
extApplicationNo	string(128)	是	外部申请单号,唯一
profile	Object	是	企业资料表单,见【底层客户资料表单】

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	ApplicationData	申请表单校验成功时返回
errors	Array<Errors>	企业档案信息校验不通过code=6802时,返回

ApplicationData字段说明

字段名	类型	描述
applicationNo	string	RD申请单号。注:拒绝后重新提交,会生成新的RD申请单号。
applicationCreateTime	int64	申请创建时间,毫秒时间戳

Errors字段说明

字段名	类型	描述
message	string	见附录:档案错误描述

请求示例

{
	"applicationNo":”rd123456“
}

响应示例

{
	"code":1,
	"message":"success",
	"data":{
		"applicationNo":”rd1234567“,
		"applicationCreateTime":123456789
	}
}

3. 查询提交申请 (QueryApplication)

接口概述 查询已提交底层客户的审核进度。 请求参数

参数名	类型	是否必填	描述
applicationNo	string	条件	RD申请单号
extApplicationNo	string	条件	外部订单号

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	QueryApplicationData	code=1时返回

QueryApplicationData字段说明

字段名	类型	描述
applicationNo	string	申请单号
extApplicationNo	string	外部订单号
applicationCreateTime	int64	申请创建时间,时间戳
applicationStatus	string	Success、Fail、In Progress
rejectReason	string	拒绝原因
companyCode	string	企业编码,申请通过时返回
profile	Object	企业资料表单,见【底层客户资料表单】

请求示例

{
	"applicationNo":”rd123456“
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "applicationNo":"20250527123456",
    "extApplicationNo":"EXT123456789",
    "applicationCreateTime":1743273600,
    "applicationStatus":"In Progress",
    "rejectReason":"0997738",
    "companyCode":"HKT12389h",
    "profile":{
      // ...
    }
  }
}

4. 查询企业详情 (QueryCompanyProfile)

接口概述 查询底层客户的详细信息。注:只能查询申请通过后的底层客户,需根据企业编号查询。 请求参数

参数名	类型	是否必填	描述
companyCode	string	是	企业编码

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	ProfileFormDto	见【底层客户资料表单】

请求示例

{
  "companyCode":"HLA9247834"
}

响应示例

{
	"code":1,
	"message":"success",
	"data":{
		// ... 见【底层客户资料表单】
	}
}

5. 创建子钱包 (CreateSubWallet)

接口概述 底层客户审核通过后，如需开通数币子钱包，可通过调用该接口创建数币子钱包。 请求参数

参数名	类型	是否必填	描述
companyCode	string	是	企业编码
purpose	string(256)	是	创建子钱包的目的

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	CreateSubWalletDto	创建钱包返回信息

请求示例

{
  "companyCode":"HLA9247834",
  "purpose":"创建子钱包的原因"
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "walletId":"WAL123456789",
    "walletType":2,
    "walletCreateTime":1743273600,
    "companyNameEn":"RD Tech",
    "companyNameCn":"圆币科技",
    "companyCode":"MSAI20250527"
  }
}

CreateSubWalletDto字段说明

字段名	类型	描述
walletId	string	钱包ID
walletType	int32	钱包类型: 2-子钱包
walletCreateTime	int64	钱包创建时间,毫秒时间戳
companyNameEn	string	企业英文名称
companyNameCn	string	企业中文名称
companyCode	string	企业编码

6. 钱包列表 (WalletList)

接口概述 查询客户所有的钱包列表。 请求参数

参数名	类型	是否必填	描述
companyCode	string	否	企业编码
walletType	int32	否	钱包类型: 1-主钱包 2-子钱包

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	WalletListDto	钱包列表数据,包含多个 WalletListDto 对象

WalletListDto 字段说明

字段名	类型	描述
walletId	int64	钱包 ID
companyCode	string	企业编码
companyName	string	企业名称
companyNameCn	string	中文企业名称
walletStatus	int32	钱包状态: 1-可用 2-冻结
createTime	int64	钱包创建时间
walletType	int32	钱包类型: 1-主钱包 2-子钱包

请求示例

{
    "companyCode":“RD001”,
	"walletType":1
}

响应示例

{
	"code":1,
	"message":"success",
	"data":[{
		"walletId":123456789,
		"companyCode":"RD001",
		"companyName":"RD Tech",
		"companyNameCn":"圆币科技",
		"walletStatus":1,
		"createTime":1693459200,
		"walletType":1
	},
	{
		"walletId":123456789,
		"companyCode":"RD002",
		"companyName":"RD Tech2",
		"companyNameCn":"圆币科技2",
		"walletStatus":1,
		"createTime":1693459200,
		"walletType":2
	}]
}

7. 收款地址查询 (ReceiveAddressQuery)

接口概述 查询指定钱包在特定区块链和币种下的收款地址。 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
network	string	是	区块链网络:ETH/TRX/SOL/POLY
currency	string	是	币种:USDT/USDC

响应参数

参数名	类型	描述
code	int64	响应码,表示请求处理结果,如 1 表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	ReceiveAddressQueryData	收款地址查询数据

ReceiveAddressQueryData 字段说明

字段名	类型	描述
address	string	收款地址

请求示例

{
  "walletId":123456789,
  "network":"ETH",
  "currency":"USDT"
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "address":"0x123456789abcdef"
  }
}

8. 钱包资产查询 (WalletAssets)

接口概述 查询钱包资产信息。 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	WalletDetailDto	钱包详情数据

WalletDetailDto 字段说明

字段名	类型	标签	描述
walletId	int64		钱包 ID
companyName	string		企业名称
companyNameCn	string		中文企业名称
walletStatus	int32		钱包状态: 1-可用 2-冻结
createTime	string		钱包创建时间
walletType	int32		钱包类型: 1-主钱包 2-子钱包
assets	AssetDto	repeated	托管资产列表
exchangeAssets	AssetDto	repeated	交易资产列表

AssetDto 字段说明

字段名	类型	描述
network	string	区块链网络,资产所属的网络；交易资产没有此字段；如:ETH\TRX
address	string	地址信息,表示资产对应的地址
currency	string	资产币种:USDT/USDC
balance	string	资产的余额

请求示例

{
  "walletId":1001
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "walletId":123456789,
    "companyName":"RD Tech",
    "companyNameCn":"圆币科技",
    "walletStatus":1,
    "createTime":"2024-05-20T10:00:00Z",
    "walletType":1,
    "assets":[
      {
        "network":"ETH",
        "address":"0x123456789abcdef",
        "currency":"USDT",
        "balance":"10.0"
      }
    ],
    "exchangeAssets":[
      {
        "address":"0x123456789abcdef",
        "currency":"USDT",
        "balance":"5.0"
      }
    ]
  }
}

底层客户资料表单

企业类型	有限公司	合伙公司	独资公司
香港地区	√	√	√
中国大陆	√	×	√
其他	√	×	×

合伙公司（香港）

实体资料（entityDetail）

参数名称	类型	是否必填	说明
businessType	int32	是	公司商业类型: 2-合伙公司
incorpPlace	string	是	公司注册地,合伙公司仅支持HKG
brNumber	string(32)	是	商业登记证书编号
brFileKey	string(128)	是	Business Registration文件
incorpDate	string	是	公司注册日期 YYYY-MM-DD
website	string(512)	否	网站URL
regPlace	string	是	公司注册所在地,见附录:国家地区编码
regAddress	string(256)	是	公司注册详细地址,仅支持英文字符、数字、空格
operatingPlace	string	是	公司运营地址,见附录:国家地区编码
operatingAddress	string(256)	是	公司运营地址详细地址
nameEn	string(128)	是	企业英文名
nameZh	string(128)	否	企业本地名/中文名
paFileKey	Array<string>	是	Partnership Agreement文件,最多5份文件
kycFileKey	Array<string>	是	该企业的KYC证明文件,最多5份文件

商业信息（businessDetail）

参数名称	类型	是否必填	说明
list	Array(BusinessDetailDto)	是	商业信息最多包含3个

BusinessDetailDto

参数名称	类型	是否必填	说明
subIndustryCode	string(10)	是	见附录:行业编码
yearsInBusiness	int32	是	见附录:经营年限
businessLocations	Array<String>(3)	是	商业地点列表,最多三个,见附录:国家地区编码
lastYearSales	int32	是	见附录:上年销售额
industryDetails	string(256)	是	行业补充说明

关键人物（keyPeople）

参数名称	类型	是否必填	说明
people	Array(KeyPeopleDto)	是	关键人物列表,填写合伙人,2-6人

KeyPeopleDto

参数名称	类型	是否必填	说明
lastNameEn	string(128)	条件	英文姓, 中英文名必填其一
firstNameEn	string(128)	条件	英文名, 中英文名必填其一
nameZh	string(128)	条件	中文名或当地名称, 中英文名必填其一
areaCode	string(8)	否	电话区号
mobileNumber	string(32)	否	手机号码
email	string(128)	否	邮箱地址
gender	int32	否	性别: 1-男 2-女
birthdate	string	否	出生日期 YYYY-MM-DD
region	string	否	证件所在国家地区,见附录: 国家地区编码
idType	int32	否	证件类型: 1-中国大陆身份证 2-中国香港身份证 3-护照
idNumber	string	否	身份证号
idFileKey	Array<string>	是	身份证文件,最多5份文件
isPartner	bool	是	是否为合伙人,true

其他

参数名称	类型	是否必填	说明
customerType	int32	是	客户类型: 1-底层客户

结构示例

{
    "entityDetail":{
        "businessType":2,
        "incorpPlace":"HKG",
        "brNumber":"br-number-partner",
        "incorpDate":2025-05-01,
        "website":"www.rd-partner.com",
        "regPlace":"HKG",
        "regAddress":"rd-partner's register address",
        "operatingPlace":"HKG",
        "operatingAddress":"rd-partner's operating address",
        "nameEn":"rd-partner partnership",
        "nameZh":"rd 合伙公司",
        "brFileKey":"4e0af338-9605-4353-86db-f35c4fdb7959.jpg",
        "paFileKey":["06993a52-3069-41c9-a048-1601a3dfade4.jpg"],
        "kycFileKey":["1747980630665348502.pdf"]
    },
    "businessDetail":{
        "list":[
            {
                "subIndustryCode":"I300734",
                "yearsInBusiness":"1",
                "businessLocations":[
                    "HKG",
                ],
                "lastYearSales":"1",
                "industryDetails":"industry's detail moments"
            }
        ]
    },
    "keyPeople":{
        "people":[
            {  
                "lastNameEn":"xx",
                "firstNameEn":"xx",
                "nameZh":"罗生",
                "areaCode":"+86",
                "mobileNumber":"124151611",
                "email":"xxx@gmail.com",
                "idFileKey":["xxxx.png"],
                "isPartner":true
            },{  // 合伙人
                "lastNameEn":"yy",
                "firstNameEn":"yy",
                "nameZh":"杨生",
                "areaCode":"+86",
                "mobileNumber":"124151612",
                "email":"yyy@gmail.com",
                "idFileKey":["xxxx.png"],
                "isPartner":true
            }
        ]
    },
    "extra":{
        "customerType":1
    }
}

有限公司（香港）

实体资料（entityDetail）

参数名称	类型	是否必填	说明
businessType	int32	是	公司商业类型: 1-有限公司
incorpPlace	string	是	公司所在地,如:HKG
ciNumber	string(32)	是	企业注册证书
ciFileKey	string(128)	是	Certificate of Incorporation文件
brNumber	string(32)	是	商业登记证书编号
brFileKey	string(128)	是	Business Registration文件
incorpDate	string	是	公司注册日期,YYYY-MM-DD
website	string(512)	否	网站URL
regPlace	string	是	公司注册地,见附录: 国家地区编码
regAddress	string(256)	是	公司注册详细地址,仅支持英文字符、数字、空格
operatingPlace	string	是	公司运营地址,见附录: 国家地区编码
operatingAddress	string(256)	是	公司运营地址详细地址
nameEn	string(128)	是	企业英文名
nameZh	string(128)	否	企业本地名（中文名）
isFinancialInstitute	int32	是	是否为受监管金融机构: 1-受监管 2-不受监管
financialRegulatorPlace	string	条件	金融监管机构所在地 ,见附录: 国家地区编码；受监管则必填
financialRegulator	string(256)	条件	监管机构名称,受监管则必填
financialLicenseType	string(128)	条件	金融机构牌照类型,受监管则必填
regulatedProofKey	Array<string>	条件	受监管证明文件,当isFinancialInstitute为true时,必填,最多5份文件
isListed	int32	是	是否为上市公司: 1-上市公司 2-非上市公司
listingPlace	string(3)	条件	上市所在地,上司公司则必填,见附录: 国家地区编码
listingExchange	string(256)	条件	交易所名称,上司公司则必填
stockCode	string(128)	条件	股票代码,上司公司则必填
isGovOwned	int32	是	是否国有: 1-国有 2-非国有
ownedGovPlace	string(3)	条件	国有公司的政府所在地,国有则必填,见附录: 国家地区编码
maFileKey	Array<string>	是	Memorandum and Articles of Association文件,最多5份文件
kycFileKey	Array<string>	是	该企业的KYC证明文件,最多5份文件

商业信息（businessDetail）

参数名称	类型	是否必填	说明
list	Array(BusinessDetailDto)	是	商业信息最多包含3个

BusinessDetailDto

参数名称	类型	是否必填	说明
subIndustryCode	string(10)	是	见附录:行业编码
yearsInBusiness	int32	是	见附录:经营年限
businessLocations	Array<String>(3)	是	商业地点列表,最多三个,见附录: 国家地区编码
lastYearSales	int32	是	见附录:上年销售额
industryDetails	string(256)	是	行业补充说明

股东结构（shareholder）

参数名称	类型	是否必填	说明
list	Array(ShareholderDto)	是	股东列表

ShareholderDto

参数名称	类型	是否必填	说明
shareholderId	int64	是	股东唯一标识,请求时在请求端生成,股东列表中不能有重复的id
sameId	int64	否	请求端生成,股东列表中两个完全相同的股东具有相同的、且大于0的sameId,默认值为0
parentId	int64	否	parent节点,对应父级的shareholderId,第一层则为0
shareholderType	int32	是	股东类型: 1-个人股东 2-企业股东
businessType	int32	条件	企业股东商业类型: 1-有限公司 2-合伙公司 3-独资公司
incorpPlace	string	条件	企业股东注册地,合伙和独资的股东注册地仅支持香港,见附录: 国家地区编码
ownedSharesPercent	double(6,3)	是	当前股东对parent的持有股份比例,3位小数,超过则四舍五入
companyNameEn	string(128)	条件	企业股东英文名,中英名必填其一
companyNameZh	string(128)	条件	企业股东本地名,中英名必填其一
financialRegulatorPlace	string	条件	金融监管机构所在地,见附录: 国家地区编码,受监管则必填
isFinancialInstitute	int32	否	企业股东是否为受监管金融机构: 1-受监管 2-不受监管
financialRegulator	string(256)	条件	监管机构名称,受监管则必填
financialLicenseType	string(128)	条件	金融机构牌照类型,受监管则必填
isListed	int32	是	企业股东是否为上市公司: 1-上市公司 2-非上市公司
listingPlace	string	条件	上市所在地,上司公司则必填,见附录: 国家地区编码
listingExchange	string(256)	条件	交易所名称,上司公司则必填
stockCode	string(128)	条件	股票代码,上司公司则必填
isGovOwned	int32	否	企业股东是否为国有,默认为2: 1-国有 2-非国有
ownedGovPlace	string	条件	国有公司的政府所在地,国有则必填,见附录:国家地区编码
firstNameEn	string(128)	条件	个人股东英文名,中英名必填其一
lastNameEn	string(128)	条件	个人股东英文姓,中英名必填其一
nameZh	string(128)	条件	个人股东本地名,中英名必填其一

关键人物（keyPeople）

参数名称	类型	是否必填	说明
quorum	int32	是	最小法定人数 1-99
directorNum	int32	是	有限公司董事人数,必须与isDirector为true的关键人物数量一致 1-99
people	Array(KeyPeopleDto)	是	列出企业所有的UBO和董事

KeyPeopleDto

参数名称	类型	是否必填	说明
lastNameEn	string(128)	条件	英文姓, 中英文名必填其一
firstNameEn	string(128)	条件	英文名, 中英文名必填其一
nameZh	string(128)	条件	中文名或当地名称
areaCode	string(8)	否	电话区号
mobileNumber	string(32)	否	手机号码
email	string(128)	否	邮箱地址
gender	int32	否	性别: 1-男 2-女
birthdate	string	否	出生日期 YYYY-MM-DD
region	string	否	证件所在国家地区,见附录:国家地区编码
idType	int32	否	证件类型: 1-中国大陆身份证 2-中国香港身份证 3-护照
idNumber	string	否	身份证号
idFileKey	Array<string>	是	身份证文件,最多5份文件
isDirector	boolean	是	是否为董事
isUbo	boolean	是	是否为最终受益人

其他

参数名称	类型	是否必填	说明
customerType	int32	是	1-底层客户

结构示例

{
    "entityDetail":{
        "businessType":1,
        "incorpPlace":"HKG",
        "ciNumber":"ci-number-hk-limit",
        "brNumber":"br-number-hk-limit",
        "incorpDate":2025-05-01,
        "website":"www.rd-limit.com",
        "regPlace":"HKG",
        "regAddress":"rd-limited's register address",
        "operatingPlace":"HKG",
        "operatingAddress":"rd-limited's register address",
        "nameEn":"rd-limited",
        "nameZh":"rd有限公司",
        "isFinancialInstitute":2,
        "isListed":2,
        "isGovOwned":2,
        "ciFileKey":"03854e86-a027-45b3-a6b4-20605b744f45.jpg",
        "brFileKey":"e02d8c60-05de-417d-9581-ac5b0dc7829e.png",
        "maFileKey":"63eb8b54-4244-43be-b8ef-26083b45a50d.jpg",
        "kycFileKey":["1747980630665348502.pdf"]
    },
    "businessDetail":{
        "list":[
            {
                "subIndustryCode":"I300734",
                "yearsInBusiness":1,
                "businessLocations":[
                    "HKG"
                ],
                "lastYearSales":1,
                "industryDetails":"industry's detail"
            }
        ]
    },
    "shareholder":{
        "list":[
            {   // 个人股东、UBO
                "shareholderId":1,
                "shareholderType":1,
                "ownedSharesPercent":40,
                "parentId":0,
                "firstNameEn":"yy",
                "lastNameEn":"yy",
                "nameZh":"杨生",
                "sameId":2     // 与shareholderId为2的股东sameId相同,则为同一个股东
            },{   // 普通企业股东
                "shareholderId":2,
                "shareholderType":2,
                "businessType":1,
                "incorpPlace":"HKG",
                "ownedSharesPercent":30,
                "parentId":0,
                "companyNameEn":"rd-limit-1",
                "companyNameZh":"rd有限1",
                "isFinancialInstitute":2,
                "isListed":2,
                "isGovOwned":2,
                "sameId":0
            },{   // 受监管的企业股东
                "shareholderId":3,
                "shareholderType":2,
                "businessType":1,
                "incorpPlace":"HKG",
                "ownedSharesPercent":20,
                "parentId":0,
                "companyNameEn":"rd-limit-2",
                "companyNameZh":"rd有限2",
                "isFinancialInstitute":1,
                "financialRegulatorPlace":"HKG",
                "financialRegulator":"HKG",
                "financialLicenseType":"支付牌照",
                "isListed":2,
                "isGovOwned":2,
                "sameId":0
            },{
                "shareholderId":4,
                "shareholderType":1,
                "ownedSharesPercent":10,
                "parentId":2,
                "firstNameEn":"yy",
                "lastNameEn":"yy",
                "nameZh":"杨生",
                "sameId":2
            }
        ]
    },
    "keyPeople":{
        "quorum":2,
        "directorNum":3,
        "people":[
            {  // 董事
                "lastNameEn":"xx",
                "firstNameEn":"xx",
                "nameZh":"罗生",
                "areaCode":"",
                "mobileNumber":"",
                "email":"xxx@gmail.com",
                "gender":1,
                "birthday":'1995-01-01',
                "region":"HK",
                "idType":2,
                "idNumber":"idnumber123",
                "isDirector":true,
                "isUbo":false
            },{   // 董事、UBO
                "lastNameEn":"yy",
                "firstNameEn":"yy",
                "nameZh":"杨生",
                "areaCode":"",
                "mobileNumber":"",
                "email":"yyy@gmail.com",
                "isDirector":true,
                "isUbo":true
            },{  // 董事
                "lastNameEn":"zz",
                "firstNameEn":"zz",
                "nameZh":"吴生",
                "areaCode":"",
                "mobileNumber":"",
                "email":"zzz@gmail.com",
                "isDirector":true,
                "isUbo":false
            }
        ]
    },
    "extra":{
        "customerType":1
    }
}

有限公司（非香港）

实体资料

参数名称	类型	是否必填	说明
businessType	int32	是	公司商业类型: 1-有限公司
incorpPlace	string	是	非HKG,公司注册地,见附录:国家地区编码
ciNumber	string(32)	是	企业注册证书
ciFileKey	string(128)	是	Certificate of Incorporation文件地址
brNumber	string(32)	否	商业登记证书编号
brFileKey	string(128)	否	Business Registration文件地址
incorpDate	string	是	公司注册日期,YYYY-MM-DD
website	string(512)	否	网站URL
regPlace	string	是	公司注册所在地,见附录:国家地区编码
regAddress	string(256)	是	公司注册详细地址,仅支持英文字符、数字、空格
operatingPlace	string	是	公司运营地址,见附录:国家地区编码
operatingAddress	string(256)	是	公司运营地址详细地址
nameEn	string(128)	条件	企业英文名,非CHN必填
nameZh	string(128)	条件	企业本地名（中文名）,CHN必填
isFinancialInstitute	int32	否	是否为受监管金融机构,默认为2: 1-受监管 2-不受监管
financialRegulatorPlace	string	条件	金融监管机构所在地,见附录: 国家地区编码,受监管则必填
financialRegulator	string(256)	条件	监管机构名称,受监管则必填
financialLicenseType	string(128)	条件	金融机构牌照类型,受监管则必填
regulatedProofKey	Array<string>	条件	受监管证明文件,isFinancialInstitute时,必填,最多5份文件
isListed	int32	否	是否为上市公司,默认为2: 1-上市公司 2-非上市公司
listingPlace	string	条件	上市所在地,见附录:国家地区编码,上司公司则必填
listingExchange	string(256)	条件	交易所名称,上司公司则必填
stockCode	string(128)	条件	股票代码,上司公司则必填
isGovOwned	int32	否	是否国有: 1-国有 2-非国有
ownedGovPlace	string(2)	条件	国有公司的政府所在地,见附录: 国家地区编码,国有则必填
maFileKey	Array<string>	是	Memorandum and Articles of Association文件地址,最多5份文件
coiFileKey	Array<string>	条件	Certificate of Incumbency, IncorpPlace为BMU、WSM、SYC、CYM、VGB时,必须提供该证明文件地址,最多5份文件
kycFileKey	Array<string>	是	该企业的KYC证明文件,最多5份文件

商业信息（businessDetail）

参数名称	类型	是否必填	说明
list	Array(BusinessDetailDto)	是	商业信息最多包含3个

BusinessDetailDto

参数名称	类型	是否必填	说明
subIndustryCode	string(10)	是	见附录:行业编码
yearsInBusiness	int32	是	见附录:经营年限
businessLocations	Array<String>(3)	是	商业地点列表,最多三个,见附录: 国家地区编码
lastYearSales	int32	是	见附录:上年销售额
industryDetails	string(256)	是	行业补充说明

股东结构（shareholder）

参数名称	类型	是否必填	说明
list	Array(ShareholderDto)	是	股东列表

ShareholderDto

参数名称	类型	是否必填	说明
shareholderId	int64	是	股东唯一标识,请求时在请求端生成,股东列表中不能有重复的id
sameId	int64	否	请求端生成,股东列表中两个完全相同的股东具有相同的、且大于0的sameId,默认值为0
parentId	int64	否	parent节点,对应父级的shareholderId,第一层则为0
shareholderType	int32	是	股东类型: 1-个人股东 2-企业股东
businessType	int32	条件	企业股东商业类型: 1-有限公司 2-合伙公司 3-独资公司
incorpPlace	string	条件	企业股东注册地,合伙和独资的股东注册地仅支持香港,见附录: 国家地区编码
ownedSharesPercent	double(6,3)	是	当前股东对parent的持有股份比例,3位小数,超过则四舍五入
companyNameEn	string(128)	条件	企业股东英文名,中英名必填其一
companyNameZh	string(128)	条件	企业股东本地名,中英名必填其一
financialRegulatorPlace	string	条件	金融监管机构所在地,见附录: 国家地区编码,受监管则必填
isFinancialInstitute	int32	否	企业股东是否为受监管金融机构: 1-受监管 2-不受监管
financialRegulator	string(256)	条件	监管机构名称,受监管则必填
financialLicenseType	string(128)	条件	金融机构牌照类型,受监管则必填
isListed	int32	是	企业股东是否为上市公司: 1-上市公司 2-非上市公司
listingPlace	string	条件	上市所在地,见附录: 国家地区编码,上市公司则必填
listingExchange	string(256)	条件	交易所名称,上司公司则必填
stockCode	string(128)	条件	股票代码,上司公司则必填
isGovOwned	int32	否	企业股东是否为国有,默认为2: 1-国有 2-非国有
ownedGovPlace	string	条件	国有公司的政府所在地,见附录: 国家地区编码,国有则必填
firstNameEn	string(128)	条件	个人股东英文名,中英名必填其一
lastNameEn	string(128)	条件	个人股东英文姓,中英名必填其一
nameZh	string(128)	条件	个人股东本地名,中英名必填其一

关键人物（keyPeople）

参数名称	类型	是否必填	说明
quorum	int32	是	最小法定人数 1-99
directorNum	int32	是	有限公司董事人数,必须与isDirector为true的关键人物数量一致 1-99
people	Array(KeyPeopleDto)	是	列出企业所有的UBO、董事

KeyPeopleDto

参数名称	类型	是否必填	说明
lastNameEn	string(128)	条件	英文姓, 中英文名必填其一
firstNameEn	string(128)	条件	英文名, 中英文名必填其一
nameZh	string(128)	条件	中文名或当地名称
areaCode	string(8)	否	电话区号
mobileNumber	string(32)	否	手机号码
email	string(128)	否	邮箱地址
gender	int32	否	性别: 1-男 2-女
birthdate	string	否	出生日期 YYYY-MM-DD
region	string	否	证件所在国家地区,见附录: 国家地区编码
idType	int32	否	证件类型: 1-中国大陆身份证 2-中国香港身份证 3-护照
idNumber	string	否	身份证号
idFileKey	Array<string>	是	身份证文件,最多5份文件
isDirector	boolean	是	是否为董事
isUbo	boolean	是	是否为最终受益人（UBO）

其他

参数名称	类型	是否必填	说明
customerType	int32	是	1-底层客户

结构示例

{
    "entityDetail":{
        "businessType":1,
        "incorpPlace":"MAC",
        "ciNumber":"ci-number-us-limit",
        "incorpDate":2025-05-01,
        "website":"www.rd-limit.com",
        "regPlace":"MAC",
        "regAddress":"rd-limited's register address",
        "operatingPlace":"MAC",
        "operatingAddress":"rd-limited's register address",
        "nameEn":"rd-limited",
        "nameZh":"rd有限公司",
        "isFinancialInstitute":2,
        "isListed":2,
        "isGovOwned":2,
        "ciFileKey":"03854e86-a027-45b3-a6b4-20605b744f45.jpg",
        "maFileKey":["63eb8b54-4244-43be-b8ef-26083b45a50d.jpg"],
        "kycFileKey":["1747980630665348502.pdf"]
    },
    "businessDetail":{
        "list":[
            {
                "subIndustryCode":"I300734",
                "yearsInBusiness":1,
                "businessLocations":[
                    "HKG"
                ],
                "lastYearSales":1,
                "industryDetails":"industry's detail"
            }
        ]
    },
    "shareholder":{
        "list":[
            {   // 个人股东,UBO
                "shareholderId":1,
                "shareholderType":1,
                "ownedSharesPercent":20,
                "parentId":0,
                "firstNameEn":"yy",
                "lastNameEn":"yy",
                "nameZh":"杨生",
                "sameId":2     与shareholderId为4的股东sameId相同,则为同一个股东
            },{   // 普通企业股东
                "shareholderId":2,
                "shareholderType":2,
                "businessType":1,
                "incorpPlace":"MAC",
                "ownedSharesPercent":40,
                "parentId":0,
                "companyNameEn":"rd-limit-1",
                "companyNameZh":"rd有限1",
                "isFinancialInstitute":2,
                "isListed":2,
                "isGovOwned":2,
                "sameId":0
            },{   // 受监管的企业股东
                "shareholderId":3,
                "shareholderType":2,
                "businessType":1,
                "incorpPlace":"MAC",
                "ownedSharesPercent":30,
                "parentId":0,
                "companyNameEn":"rd-limit-2",
                "companyNameZh":"rd有限2",
                "isFinancialInstitute":1,
                "financialRegulatorPlace":"MAC",
                "financialRegulator":"MAC金管局",
                "financialLicenseType":"支付牌照",
                "isListed":2,
                "isGovOwned":2,
                "sameId":0
            },{
                "shareholderId":4,
                "shareholderType":1,
                "ownedSharesPercent":10,
                "parentId":2,
                "firstNameEn":"yy",
                "lastNameEn":"yy",
                "nameZh":"杨生",
                "sameId":2
            }
        ]
    },
    "keyPeople":{
        "quorum":2,
        "directorNum":3,
        "people":[
            {  // 董事
                "lastNameEn":"xx",
                "firstNameEn":"xx",
                "nameZh":"罗生",
                "areaCode":"",
                "mobileNumber":"",
                "email":"xxx@gmail.com",
                "gender":1,
                "birthday":'1995-01-01',
                "region":"HK",
                "idType":2,
                "idNumber":"idnumber123",
                "isDirector":true,
                "isUbo":false
            },{   // 董事、UBO
                "lastNameEn":"yy",
                "firstNameEn":"yy",
                "nameZh":"杨生",
                "areaCode":"",
                "mobileNumber":"",
                "email":"yyy@gmail.com",
                "isDirector":true,
                "isUbo":true
            },{  // 董事
                "lastNameEn":"zz",
                "firstNameEn":"zz",
                "nameZh":"吴生",
                "areaCode":"",
                "mobileNumber":"",
                "email":"zzz@gmail.com",
                "isDirector":true,
                "isUbo":false
            }
        ]
    },
    "extra":{
        "customerType":1
    }
}

独资公司（香港/中国大陆）

实体资料

	类型	是否必填	说明
businessType	int32	是	公司商业类型: 3-独资公司
incorpPlace	string	是	公司注册地,独资公司仅支持:HKG/CHN
brNumber	string(32)	是	商业登记证书编号
brFileKey	string(128)	是	Business Registration文件
incorpDate	int32	是	公司注册日期,yyyy-MM-dd
website	string(512)	否	网站URL
isFinancialInstitute	int32	否	是否为受监管金融机构: 1-受监管 2-不受监管
financialRegulatorPlace	string	条件	金融监管机构所在地,见附录: 国家地区编码编码,受监管则必填
financialRegulator	string(256)	条件	监管机构名称,受监管则必填
financialLicenseType	string(128)	条件	金融机构牌照类型,受监管则必填
regulatedProofKey	Array<string>	条件	受监管证明文件,isFinancialInstitute为1时,必填,最多5份文件
regPlace	string	是	公司注册所在地,见附录: 国家地区编码
regAddress	string(256)	是	公司注册详细地址,仅支持英文字符、数字、空格
operatingPlace	string(2)	是	公司运营地址,见附录: 国家地区编码
operatingAddress	string(256)	是	公司运营地址详细地址
nameEn	string(128)	条件	企业英文名,HKG必填
nameZh	string(128)	条件	企业本地名/中文名,CHN必填
kycFileKey	Array<string>	是	该企业的KYC证明文件,最多5份文件

商业信息（businessDetail）

参数名称	类型	是否必填	说明
list	Array(BusinessDetailDto)	是	商业信息至少1个,最多包含3个。

BusinessDetailDto

参数名称	类型	是否必填	说明
subIndustryCode	string(10)	是	见附录:行业编码
yearsInBusiness	int32	是	见附录:经营年限
businessLocations	Array<String>(3)	是	商业地点列表,最多三个,见附录: 国家地区编码
lastYearSales	int32	是	见附录:上年销售额
industryDetails	string(256)	是	行业补充说明

关键人物（keyPeople）

参数名称	类型	是否必填	说明
people	Array(KeyPeopleDto)	是	填写一位owner

KeyPeopleDto

参数名称	类型	是否必填	说明
lastNameEn	string(128)	条件	英文姓
firstNameEn	string(128)	条件	英文名
nameZh	string(128)	条件	中文名或当地名称
areaCode	string(8)	否	电话区号
mobileNumber	string(32)	否	手机号码
email	string(128)	否	邮箱地址
gender	int32	否	性别: 1-男 2-女
birthdate	string	否	出生日期 YYYY-MM-DD
region	string	否	证件所在国家地区,见附录:国家地区编码
idType	int32	否	证件类型: 1-中国大陆身份证 2-中国香港身份证 3-护照
idNumber	string	否	身份证号
idFileKey	Array<string>	是	身份证文件,最多5份文件
isOwner	boolean	是	是否为独资公司拥有人（有且仅有一个）

其他

参数名称	类型	是否必填	说明
customerType	int32	是	1-底层客户

结构示例

{
    "entityDetail":{
        "businessType":3,
        "incorpPlace":"HKG",
        "brNumber":"br-number-sole",
        "incorpDate":2025-05-01,
        "website":"www.rd-sole.com",
        "regPlace":"HKG",
        "regAddress":"rd-sole's register address",
        "operatingPlace":"HKG",
        "operatingAddress":"rd-sole's operating address",
        "nameEn":"rd-sole",
        "nameZh":"rd 独资公司",
        "isFinancialInstitute":2,
        "financialRegulatorPlace":"",
        "financialRegulator":"",
        "financialLicenseType":"",
        "brFileKey":"4e0af338-9605-4353-86db-f35c4fdb7959.jpg",
        "kycFileKey":["1747980630665348502.pdf"]
        
    },
    "businessDetail":{
        "list":[
            {
                "subIndustryCode":"I300734",
                "yearsInBusiness":1,
                "businessLocations":[
                    "CHN"
                ],
                "lastYearSales":1,
                "industryDetails":"industry's detail moments"
            }
        ]
    },
    "keyPeople":{
        "people":[
          { 
                "lastNameEn":"zz",
                "firstNameEn":"zz",
                "nameZh":"吴生",
                "areaCode":"+86",
                "mobileNumber":"124151613",
                "email":"zzz@gmail.com",
                "isOwner":true
            }
        ]
    },
    "extra":{
        "customerType":1
    }
}

WalletPaymentAPI

1. 钱包转账 (WalletTransfer)

接口概述 执行平台内钱包与钱包之间资金转账。 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	转出钱包的 ID
targetWalletId	int64	是	转入钱包的 ID
currency	string	是	转账币种:USDT/USDC
network	string	是	转账币种所在网络:ETH/TRX/SOL/POLY
amount	string	是	转账金额
extOrderNo	string	是	外部订单 ID,唯一
message	string	否	转账附言

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,表示转账操作的描述或错误信息
data	WalletTransferData	转账操作的数据

WalletTransferData 字段说明

字段名	类型	描述
orderNo	string	RD 订单号

请求示例

{
  "walletId":1001,
  "targetWalletId":1002,
  "currency":"USDT",
  "network":"ETH",
  "amount":"1.0",
  "extOrderNo":"EXT123456789",
  "message":"转账附言"
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "orderNo":"ORDER123456789"
  }
}

2. 获取签名 (GetSignData)

接口概述 获取签名。 请求参数

参数名	类型	是否必填	描述
network	string	是	区块链网络:ETH/TRX/SOL/POLY
address	string	是	要添加白名单的地址

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,表示操作的结果或错误信息
data	SignData	签名响应数据

SignData字段说明

字段名	类型	描述
data	string	签名数据
expireTime	int64	签名过期时间

请求示例

{
  "network":"ETH",
  "address":"0x123456789abcdef"
}

响应示例

{
  "code":1,
  "message":"Success",
  "data":
  {
      "data":"93fb699d-160e-43a0-b053-817ca4bbdcfd;1746755842000",
      "expireTime":1746755842000
  }
}

3. 添加地址白名单 (AddAddressWhitelist)

接口概述 添加地址到白名单。 请求参数

参数名	类型	是否必填	描述
network	string	是	区块链网络:ETH/TRX/SOL/POLY
address	string	是	要添加的地址
checkType	int32	是	检查类型: 1-签名检查 2-交易检查
signData	string	条件	签名信息,检查类型为签名时必填
signature	string	条件	签名结果,检查类型为签名时必填
currency	string	条件	检查类型为交易时必填。收款币种:USDT/USDC
walletId	int64	是	收款钱包 ID
businessType	int32	是	业务类型: 1-deposit 2-withdraw
addressSource	int32	是	地址来源类型: 1-个人钱包 2-交易所/托管平台
platformName	string	条件	所属交易所/托管平台名称,地址来源类型是2时必填
remarks	string	否	备注

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,表示操作的结果或错误信息
data	WhiteListApiDto	白名单添加结果

WhiteListApiDto 字段说明

字段名	类型	描述
id	int64	请求id
network	string	区块链网络:ETH/TRX/SOL/POLY
address	string	要添加的地址
checkType	int32	检查类型: 1-签名检查 2-小额转账检查
signData	string	待签名数据
signature	string	签名
currency	string	小额转账的币种:USDT/USDC
depositAddress	string	小额转账的收款地址
amount	string	小额转账需要打款的金额
status	string	状态: SUCCESS、FAIL、PENDING、PENDING_DEPOSIT
expireTime	int64	小额转账打款截止时间
businessType	int32	业务类型: 1-deposit 2-withdraw
addressSource	int32	地址来源类型: 1-个人钱包 2-交易所/托管平台
platformName	string	所属交易所/托管平台名称
remarks	string	备注

请求示例

// checkType = 1 签名检查
{
  "network":"ETH",
  "address":"0x123456789abcdef",
  "checkType":1,
  "businessType":1,
  "walletId":429883231600640,
  "addressSource":1,
  "remarks":"this is a remark",
  "signature":"0x1e2bc15251969197f9ceedd8dc327f1ab0c993a7cd0a12794414b62be653cda410b2cd48950ffb7ee3184dcd13ce0674eefde540ce2983a0c9e91c6c4893cea51b",
  "signData":"4553493b-7734-435a-8c93-9ae92e89c99e;1746612121000"
}

// checkType = 2 交易检查
{
  "network":"ETH",
  "address":"0x123456789abcdef",
  "checkType":2,
  "businessType":1,
  "addressSource":1,
  "remarks":"this is a remark",
  "currency":"USDT",
  "walletId":429883231600640
}

响应示例

{
    "code":1,
    "message":"Success",
    "data":{
        "id":708258726632620032,
        "network":"ETH",
        "address":"0x022a50AE43baC1FBECC160a01a7eb13c64553d7F6",
        "checkType":1,
        "signData":"93fb699d-160e-43a0-b053-817ca4bbdcfd;1746755842000",
        "signature":"93fb699d-160e-43a0-b053-817ca4bbdcfd;1746755842000",
        "currency":"",
        "depositAddress":"",
        "amount":"",
        "status":"PENDING",
        "expireTime":0,
        "businessType":1,
        "addressSource":1,
        "platformName":"",
        "remarks":"this is a withdraw remark"
    }
}

4. 校验地址白名单 (CheckAddressWhitelist)

接口概述 检查地址是否在白名单中。 请求参数

参数名	类型	是否必填	描述
address	string	是	地址,检查该地址是否在白名单中
network	string	是	区块链网络:ETH/TRX/SOL/POLY
businessType	int32	是	业务类型: 1-deposit 2-withdraw

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的错误信息或状态描述
data	CheckWhiteListDto	白名单检查结果

CheckWhiteListDto 字段说明

字段名	类型	描述
status	string	状态: SUCCESS、FAIL、PENDING、PENDING_DEPOSIT、NOT_EXIST
businessType	int32	业务类型: 1-deposit 2-withdraw
remarks	string	备注

请求示例

{
  "network":"ETH",
  "address":"0x123456789abcdef",
  "businessType":1
}

响应示例

{
  "code":1,
  "message":"success",
  "data":
  {
    "businessType":1,
    "status ":"SUCCESS",
    "remarks":"deposit白名单"
  }
}

5. 删除地址白名单 (DeleteAddressWhitelist)

接口概述 删除地址白名单。 请求参数

参数名	类型	是否必填	描述
network	string	是	区块链网络:ETH/TRX/SOL/POLY
address	string	是	要删除的地址白名单
businessType	int32	是	业务类型: 1-deposit 2-withdraw

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,表示操作的结果或错误信息

请求示例

{
  "network":"ETH",
  "address":"0x123456789abcdef",
  "businessType":1
}

响应示例

{
  "code":1,
  "message":"success"
}

6. 申报收款订单 (DeclareReceiveOrder)

接口概述 申报收款订单。 请求参数

参数名	类型	是否必填	描述
senderAddress	string	是	支付方地址
recipientAddress	string	是	收款方地址
amount	string	是	金额,表示存款金额
network	string	是	区块链网络:ETH/TRX/SOL/POLY
currency	string	是	币种 :USDT/USDC
extOrderNo	string	是	外部订单 ID,全局唯一

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,表示操作的结果或错误信息
data	WalletTransferData

请求示例

{
  "senderAddress":"0x123456789abcdef",
  "recipientAddress":"0x987654321fedcba",
  "amount":"1000.0",
  "network":"ETH",
  "currency":"USDT",
  "extOrderNo":"EXT123456789"
}

响应示例

{
  "code":1,
  "message":"success"
}

7. 划拨 (InternalTransfer)

接口概述 执行内部划拨操作。 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
internalTransferType	int32	是	内部划拨类型: 1-托管资产往交易资产划转
network	string	条件	来源资产的网络:ETH/TRX/SOL/POLY,划拨类型为1时必填
currency	string	是	币种:USDT/USDC
amount	string	是	金额
extOrderNo	string	是	外部订单 ID,用于唯一标识划拨请求

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	InternalTransferData	内部划拨操作的数据

InternalTransferData 字段说明

字段名	类型	描述
orderNo	string	划拨订单号

请求示例

{
  "walletId":1001,
  "internalTransferType":1,
  "network":"ETH",
  "currency":"USDT",
  "amount":"1.0",
  "extOrderNo":"EXT123456789"
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "orderNo":"ORDER123456789"
  }
}

8. 订单详情 (WalletOrderDetail)

接口概述 查询钱包订单详情。 请求参数

参数名	类型	是否必填	描述
orderNo	string	条件	订单号 orderNo/extOrderNo 二者必填一
extOrderNo	string	条件	外部订单号,用于查询订单详情 orderNo/extOrderNo 二者必填一

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的错误信息或处理结果描述
data	WalletOrderDetailData	订单详情数据

WalletOrderDetailData 字段说明

字段名	类型	描述
orderNo	string	订单号
extOrderNo	string	外部订单号
orderType	string	订单类型
orderStatus	string	见附录：入金订单状态
fromAddress	string	发起方地址
fromWallet	string	来源钱包
toAddress	string	接收方地址
toWallet	string	目标钱包
amount	string	金额
network	string	区块链网络：ETH、TRX
currency	string	币种：USDT、USDC
expireTime	int64	订单过期时间
createTime	int64	订单创建时间

请求示例

{
  "orderNo":"ORDER123456789"
}

响应示例

{
    "code":1,
    "message":"success",
    "data":{
        "orderNo":"447767487604736",
        "extOrderNo":"1744341998597",
        "orderType":"PayIn",
        "orderStatus":"SUCCESSFUL",
        "fromAddress":"0x213F2B229BE4f3FFF88fc874a986b19D79623339",
        "toAddress":"0xc496E20b19F009543E49b8512CB990ceb0a230F0",
        "toWallet":"429883231600640",
        "amount":"17",
        "network":"ETH",
        "currency":1744342001561,
        "expireTime":1744342629783,
        "createTime":1744343297296
    }
}

9. Request Payment订单申报(RequestPaymentOrderDeclare)

接口概述 申报Request Payment入金订单 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	入金钱包 ID
extOrderNo	string	是	外部订单 ID，用于唯一标识转账请求
senderAddress	string	是	付款方钱包地址
network	string	是	区块链网络：ETH、TRX
currency	string	是	币种：USDT、USDC
amount	string	是	申报金额注意:申报金额需要和最终入金金额完全匹配
senderName	string	是	付款方名称
countryRegion	string	是	支付方所在国家/地区 ISO 3166编码：如HKG
contactAddress	string	是	付款方联系住址
receiverName	string	是	收款商户名称
message	string	否	附言
materials	Array	否	订单还原材料申报对象集合
productType	string	是	商品类型
productName	string	是	商品名称
productPrice	string	是	商品价格
productCount	string	是	商品数量
productUnit	string	是	商品单位
logisticsTrackingName	string	否	物流公司名称
logisticsTrackingNo	string	否	物流单号

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理的结果
message	string	响应消息,表示操作的结果或错误信息

请求示例

{
	"walletId":"429883231600640",
	"extOrderNo":"1747626211614",
	"senderAddress":"0x213F2B229BE4f3FFF88fc874a986b19D79623339",
	"network":"ETH",
	"currency":"USDC",
	"senderName":"Reflective Method Invocation",
	"countryRegion":"HKG",
	"contactAddress":"contact address hong kong",
	"receiverName":"Reflective Method Invocation",
	"message":"request payment msg",
	"materials":[{
		"productType":"Electronics",
		"productName":"Wireless Bluetooth Headphones",
		"productPrice":"89.99",
		"productCount":"150",
		"productUnit":"pcs",
		"logisticsTrackingName":"FedEx International Priority",
		"logisticsTrackingNo":"FX123456789US"
	}],
	"amount":"150"
}

响应示例

{
  "code":1,
  "message":"success"
}

10. Request Payment订单材料补充(AddRequestPaymentMaterials)

接口概述 申报订单补充商品信息等材料 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	入金钱包 ID
orderNo	string	是	订单 ID
materials	Array	否	订单还原材料申报对象集合
productType	string	是	商品类型
productName	string	是	商品名称
productPrice	string	是	商品价格
productCount	string	是	商品数量
productUnit	string	是	商品单位
logisticsTrackingName	string	否	物流公司名称
logisticsTrackingNo	string	否	物流单号

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理的结果
message	string	响应消息，表示操作的结果或错误信息

请求示例

{
  "walletId":"429883231600640",
  "orderNo":"447767487604736",
  "materials":[{
		"productType":"Electronics",
		"productName":"Wireless Bluetooth Headphones",
		"productPrice":"89.99",
		"productCount":"150",
		"productUnit":"pcs",
		"logisticsTrackingName":"FedEx International Priority",
		"logisticsTrackingNo":"FX123456789US"
	}]
}

响应示例

{
  "code":1,
  "message":"success"
}

11. 费用查询(feeQuery)

接口概述 费用查询接口,查询交易所需的手续费。 请求参数

参数名	类型	是否必填	描述
orderType	int32	是	见附录：订单类型
walletId	int64	是	钱包 ID
network	string	是	区块链网络：ETH、TRX
currency	string	是	币种：USDT、USDC
payAmount	string	是	下单金额

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理结果，如 1表示成功，其他值表示不同错误情况
message	string	响应消息，表示操作的结果或错误信息
data	费用详情

费用详情字段说明

字段名	类型	描述
walletId	int64	钱包ID
network	string	区块链网络：ETH、TRX
currency	string	币种：USDT、USDC
payAmount	string	下单金额
feeAmount	string	手续费
receiveAmount	string	收款金额

请求示例

{
  "walletId":"429883231600640",
  "network":"ETH",
  "currency":"USDC",
  "payAmount":"666.66"
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "walletId":"429883231600640",
    "network":"ETH",
    "currency":"USDC",
    "payAmount":"666.66",
    "feeAmount":"19.9998",
    "receiveAmount":"646.6602"
  }
}

12. 提现下单(withdraw)

接口概述 创建提现订单 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
extOrderNo	string	是	外部订单 ID，用于唯一标识转账请求
network	string	是	区块链网络：ETH/TRX/SOL/POLY
currency	string	是	币种：USDT 、USDC
payAmount	string	是	下单金额，最大支持6位小数
recipientAddress	string	是	收款方区块地址
recipientName	string	是	收款方名称
message	string	否	备注

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理结果，如 1表示成功，其他值表示不同错误情况
message	string	响应消息，表示操作的结果或错误信息

请求示例

{
  "walletId":"429883231600640",
  "extOrderNo":"ext-1745477734002",
  "network":"ETH",
  "currency":"USDC",
  "recipientAddress":"0x213F2B229BE4f3FFF88fc874a111b19D79623339",
  "message":"Message ttt",
  "payAmount":"666.66"
}

响应示例

{
    "code":1,
    "message":"success"
}

13. 对账单下载(queryReconBill)

接口概述 每日上午9点,可提供D-1日对账单下载（备注:文档涉及时间对应时区为香港UTC+8时区） 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
billDate	string	是	账单日期，格式：yyyyMMdd
modeType	int32	是	授权模式： 1-直连模式（下载当前钱包的对账单） 2-授权模式（下载当前钱包以及子钱包对账单）
accountType	int32	是	账户类型： 1-存管账户 2-交易账户
currencyType	int32	是	币种类型： 1:ETH-USDT（存管户币种） 2:ETH-USDC（存管户币种） 3:TRX-USDT（存管户币种） 4:USDT（交易账户币种） 5:USDC（交易账户币种） 6:USD(存管账户、交易账户币种) 14:SOL-USDC(存管户币种) 15:SOL-USDT(存管户币种) 16:POLY-USDC(存管户币种) 17:POLY-USDT(存管户币种)

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理的结果
message	string	响应消息，表示操作的结果或错误信息
data	WalletBillData	对账单信息

WalletBillData字段说明

字段名	类型	描述
fileName	string	文件名称
fileUrl	string	对账单zip包下载地址

请求示例

{
    "walletId ":123456789,
    "billDate":"20250330",
    "modeType":1,
    "accountType":1,
    "currencyType":1
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "fileName":"20231123_123456789_Statement_ETHUSDT.zip",
    "fileUrl":"https://hk-pro-wallet-private-oss.oss-cn-hongkong.aliyuncs.com/thirdpartybilling/1737925914987610112.zip?Expires=1703216183&OSSAccessKeyId=LTAI5tKJmyxrRXQgpGwhhVnK&Signature=8MXwogxJ0NXBZ3FTS6O97%2B%2FpEiQ%3D",
  }
}

ConvertAPI

PayoutModel

1. 询价(payoutQuote)

接口概述 用于获取指定币种对的价格及转账相关信息 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
fromCurrency	string	是	币种：USDT、USDC
fromAmount	string	否	金额，支持2位小数，fromAmount和toAmount二选一
toCurrency	string	是	币种：USD
toAmount	string	否	金额，支持2位小数，fromAmount和toAmount二选一
paymentWay	string	是	支付方式：RDT、CHATS
feeMode	int32	否	paymentWay=CHATS 必填手续费扣费模式： 1-收付双方共同承担（SHAR） 2-付款方承担所有手续费（OUR) paymentWay=CHATS 必填

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	PayoutQuoteData	价格及转账相关数据

PayoutQuoteData 字段说明

字段名	类型	描述
walletId	int64	钱包 ID
fromCurrency	string	币种：USDT、USDC
fromAmount	string	金额
toCurrency	string	币种，USD
toAmount	string	金额（减去手续费）
paymentWay	string	支付方式：RDT、CHATS
feeMode	int32	手续费扣费模式，默认值：1 1-收付双方共同承担（SHAR） 2-付款方承担所有手续费（OUR)
quoteId	int64	询价 ID
price	string	价格
priceExpireTime	string	价格有效截止时间
feeAmount	string	手续费
feeCurrency	string	手续费币种

请求示例

{
	"walletId":1000232233L,
	"fromCurrency":"USDT",
	"fromAmount":"200.12",
	"toCurrency":"USD",
	"paymentWay":"CHATS",
	"feeMode":1
}

响应示例

{
  "code":1,
  "message":"Success",
  "data":{
    "walletId":"429405186232384",
    "fromCurrency":"USDT",
	"fromAmount":"200.12",
	"toCurrency":"USD",
    "toAmount":"192.83",
	"paymentWay":"CHATS",
	"feeMode":1
    "quoteId":"665131773713321985",
    "price":"0.9986",
    "priceExpireTime":"1736387772381",
	"feeAmount":"7",
	"feeCurrency":"USD"
  }
}

2. 下单(payoutBook)

接口概述 用于指定币种对的价格下单。 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
quoteId	int64	是	询价 ID
settlementAccountUID	int64	是	结算账户标识，通过getBankAccount可查询得到
purpose	string	是	见附录：付款目的
extOrderNo	string	是	业务方订单号（只能是数字、大小写字母_-*且在同一个商户号下唯一）

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理结果，如 1 表示成功，其他值表示不同错误情况
message	string	响应消息，提供详细的处理信息或错误说明
data	PayoutBookData	下单数据

PayoutBookData 字段说明

字段名	类型	描述
walletId	int64	钱包 ID
quoteId	int64	询价 ID
settlementAccountUID	int64	结算账户标识
purpose	string	见附录：付款目的
orderNo	string	订单号
fromCurrency	string	币种
fromAmount	string	金额
toCurrency	string	币种
toAmount	string	金额（减去手续费）
paymentWay	string	支付方式：RDT/CHATS
feeMode	int32	手续费扣费模式，默认值：1 1-收付双方共同承担（SHAR） 2-付款方承担所有手续费（OUR)
feeAmount	string	手续费
feeCurrency	string	手续费币种
orderStatus	string	见附录:Payout订单状态
createTime	int64	订单创建时间
extOrderNo	string	业务方订单号（只能是数字、大小写字母_-*且在同一个商户号下唯一）

请求示例

{
	"walletId":1000232233L,
	"quoteId":665131773713321985,
	"settlementAccountUID":"48775048489845",
	"purpose":"GOF"
}

响应示例

{
  "code":1,
  "message":"Success",
  "data":{
    "walletId":"429405186232384",
    "quoteId":"665205920267108353",
    "settlementAccountUID":1236547995462114,
	"purpose":"GOF",
    "orderNo":"431513431160832",
    "fromCurrency":"USDT",
	"fromAmount":"200.12",
	"toCurrency":"USD",
    "toAmount":"192.83",
	"paymentWay":"CHATS",
	"feeMode":1
   	"feeAmount":"7",
	"feeCurrency":"USD"
    "orderStatus":"SUBMITTED",
    "createTime":"1736405450558",
    "extOrderNo":"1234567898"
  }
}

3. 订单查询(payoutEnquiry)

接口概述 用于查询订单信息 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
orderNo	string	否	RD系统订单号，orderNo 和 quoteId 最少选择一个
quoteId	int64	否	查询价格返回的quoteId，orderNo 和 quoteId 最少选择一个

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理结果，如 1表示成功，其他值表示不同错误情况
message	string	响应消息，提供详细的处理信息或错误说明
data	PayoutData	订单查询数据

PayoutData 字段说明

字段名	类型	描述
walletId	int64	钱包 ID
quoteId	int64	询价 ID
orderNo	string	订单号
fromCurrency	string	币种
fromAmount	Side	金额
toCurrency	string	币种
toAmount	string	金额
tradeFromAmount	string	成交金额
tradeToAmount	string	成交金额
price	string	下单价格
tradePrice	string	成交价格
orderStatus	string	见附录：Payout订单状态
createTime	int64	订单创建时间
finishTime	int64	订单完成时间
errorMsg	string	订单失败原因
settlementAccountUID	int64	结算账户标识
purpose	string	见附录：付款目的(purpose)
paymentWay	string	支付方式：RDT/CHATS
feeMode	int32	手续费扣费模式，默认值：1 1-收付双方共同承担（SHAR） 2-付款方承担所有手续费（OUR)
feeAmount	string	手续费
feeCurrency	string	手续费币种
refundOrderNo	string	失败时，退款订单号
refundAmount	string	失败时，退款金额
refundCurrency	string	失败时，退款币种
extOrderNo	string	业务方订单号

请求示例

{
	"walletId":1000232233L,
	"quoteId":665131773713321985
}

响应示例

{
  "code":1,
  "message":"Success",
  "data":{
     "walletId":1000232233L,
	  "quoteId":665131773713321985
      "orderNo":"442112731049984"
      "fromCurrency":"USDT",
	  "fromAmount":"200.12",
	  "toCurrency":"USD",
      "toAmount":"192.83",
      "tradeFromAmount":"200.12"
      "tradeToAmount":"192.83"
      "price":"1.142"
      "tradePrice":"1.142"
      "orderStatus":"SUCCESSFUL"
      "createTime":1741580889957,
      "finishTime":1741580889957,
      "settlementAccountUID":1236547995462114,
	  "purpose":"GOF",
      "paymentWay":"CHATS",
	  "feeMode":1,
	  "feeAmount":"7",
	  "feeCurrency":"USD",
      "extOrderNo":"1234567898"
  }
}
   

4. 重新结算(payoutReSettle)

接口概述 用于结算失败或者结算退款后重新发起结算。 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
orderNo	string	是	Payout 订单号
refundOrderNo	string	是	退款订单号
settlementAccountUID	int64	是	结算账户标识
purpose	string	是	见附录:付款目的(purpose)
remark	string	是	描述
paymentWay	string	是	支付方式:RDT/CHATS
feeMode	int32	否	paymentWay=CHATS 必填手续费扣费模式,默认值：1 1-收付双方共同承担（SHAR） 2-付款方承担所有手续费（OUR)

响应参数

参数名	类型	描述
code	int32	响应码,表示请求处理结果,如 1 表示成功,其他值表示不同错误情况
message	string	响应消息,提供详细的处理信息或错误说明
data	PayoutReSettleData	下单数据

PayoutReSettleData 字段说明

字段名	类型	描述
walletId	int64	钱包 ID
orderNo	string	Payout 订单号
refundOrderNo	string	退款订单号
settlementAccountUID	int64	结算账户标识
purpose	string	见附录：付款目的(purpose)
remark	string	描述
paymentWay	string	支付方式：RDT/CHATS
feeMode	int32	手续费扣费模式，默认值：1 1-收付双方共同承担（SHAR） 2-付款方承担所有手续费（OUR)
amount	string	重新结算金额
currency	int64	重新结算币种
feeAmount	string	手续费
feeCurrency	string	手续费币种

请求示例

{
	"walletId":1000232233L,
	"orderNo":"442112731049984",
	"refundOrderNo":"232112731049984",
	"settlementAccountUID":1236547995462114,
	"purpose":"GOF",
	"remark":"remark",
    "paymentWay":"CHATS",
	"feeMode":1
}

响应示例

{
  "code":1,
  "message":"Success",
  "data":{
    "walletId":1000232233L,
	"orderNo":"442112731049984",
	"refundOrderNo":"232112731049984",
	"settlementAccountUID":1236547995462114,
	"purpose":"GOF",
	"remark":"remark",
    "paymentWay":"CHATS",
	"feeMode":1
    "amount":"183",
	"currency":"USD"
	"feeAmount":"7",
	"feeCurrency":"USD"
  }
}

5. 添加收款账号(addBankAccount)

接口概述 添加收款账号 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
alias	string	是	别名
accountOwnership	int32	是	绑定钱包(walletId )关系: 1-own account 2-other account 3=Third party
currency	string	是	币种：USD
accountType	int32	是	账户类型: 1-RD Wallet 2-Bank Account
companyName	string	是	公司名称 accountOwnership=2，该名称必须和companyCode公司名称一致
accountNumber	string	是	账号，RD Wallet Id or Bank Number
bankId	string	是	香港银行id，例如：003
beneficiaryAddress1	string	否	收款方地址1(不允许中文)，accountType=2时必填
beneficiaryAddress2	string	否	收款方地址2(不允许中文)，accountType=2时必填
beneficiaryAddress3	string	否	收款方地址3：国家/地区 ISO 3166编码，accountType=2时必填
beneficiarySwiftCode	string	否	银行Swift Code，必须是HK地区，accountType=2时必填
intermediarySwiftCode	string	否	中间银行Swift Code，必须是HK地区
companyCode	string	否	企业编码accountOwnership=2，必填
paymentFiles	Array<FileInfo>	否	支付证明文件，accountOwnership=3必填
remark	string	否	备注，accountOwnership=3选填

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理结果，如 1表示成功，其他值表示不同错误情况
message	string	响应消息，表示操作的结果或错误信息
data	BankAccountData	账户信息

BankAccountData字段说明

参数名	类型	描述
settlementAccountUID	int64	结算账户标识
walletId	int64	钱包 ID
alias	string	别名
accountOwnership	int32	绑定钱包(walletId )关系： 1-own account 2-other account
currency	string	币种:USD
accountType	int32	账户类型: 1-RD Wallet 2-Bank Account
companyName	string	公司名称
accountNumber	string	账号, RD Wallet Id or Bank Number
bankId	string	香港银行id，例如：003
beneficiaryAddress1	string	收款方地址1(不允许中文)
beneficiaryAddress2	string	收款方地址2(不允许中文)
beneficiaryAddress3	string	收款方地址3：国家/地区 ISO 3166编码
beneficiarySwiftCode	string	银行Swift Code
intermediarySwiftCode	string	中间银行Swift Code
companyCode	string	企业编码
status	int32	状态： 0-处理中 1-成功 2-失败
paymentFiles	Array<FileInfo>	支付证明文件
remark	string	备注

FileInfo字段说明

参数名	类型	描述
fileKey	文件ID	调用上传接口后会返回
fileName	文件名称
fileUrl	文件URL	调用上传接口后会返回，定期会更新URL

请求示例

{
    "walletId":4298832316123456,
    "alias":"name alias",
    "accountOwnership":2,
    "currency":"USD",
    "accountType":2,
    "companyName":"narti adiddf",
    "accountNumber":"8888888",
    "bankId":"003",
    "beneficiaryAddress1":"payee address1",
    "beneficiaryAddress2":"payee address2",
    "beneficiaryAddress3":"HK",
    "beneficiarySwiftCode":"DHBKHKHHXXX",
    "intermediarySwiftCode":"DHBKHKHHXXX",
    "companyCode":"HK1239876654",
    "paymentFiles": [
      {
        "fileKey": "file_key_123",
        "fileName": "证明文件.pdf",
      }
    ],
    "remark": "备注信息"
}

响应示例

{
    "code":1,
    "message":"success",
    "data":{
        "settlementAccountUID":1236547995462114,
        "walletId":4298832316123456,
        "alias":"name alias",
        "accountOwnership":2,
        "currency":"USD",
        "accountType":2,
        "companyName":"narti adiddf",
        "accountNumber":"8888888",
        "bankId":"003",
        "beneficiaryAddress1":"payee address1",
        "beneficiaryAddress2":"payee address2",
        "beneficiaryAddress3":"HK",
        "beneficiarySwiftCode":"DHBKHKHHXXX",
        "intermediarySwiftCode":"DHBKHKHHXXX",
        "companyCode":"HK1239876654",
        "status":0,
        "paymentFiles": [
          {
            "fileKey": "file_key_123",
            "fileName": "证明文件.pdf",
            "fileUrl" "https://xxxxx"
          }
        ],
        "remark": "备注信息"
    }
}

6. 更新收款账号(updateBankAccount)

接口概述 更新收款账号 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
settlementAccountUID	int64	是	结算账户标识
alias	string	否	别名
accountNumber	string	否	账号, RD Wallet Id or Bank account number
bankId	string	否	香港银行id，例如：003
beneficiaryAddress1	string	否	收款方地址1(不允许中文)
beneficiaryAddress2	string	否	收款方地址2(不允许中文)
beneficiaryAddress3	string	否	收款方地址3：国家/地区 ISO 3166编码
beneficiarySwiftCode	string	否	银行Swift Code，必须是HK地区
intermediarySwiftCode	string	否	中间银行Swift Code，必须是HK地区
paymentFiles	Array<FileInfo>	否	支付证明文件，accountOwnership=3必填
remark	string	否	备注，accountOwnership=3选填

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理结果，如 1表示成功，其他值表示不同错误情况
message	string	响应消息，表示操作的结果或错误信息
data	BankAccountData	账户信息

BankAccountData字段说明

参数名	类型	描述
settlementAccountUID	int64	结算账户标识
walletId	int64	钱包 ID
alias	string	别名
accountOwnership	int32	绑定钱包(walletId )关系： 1-own account 2-other account
currency	string	币种：USD
accountType	int32	账户类型： 1-RD Wallet 2-Bank Account
companyName	string	公司名称
accountNumber	string	账号, RD Wallet Id or Bank account number
bankId	string	香港银行id，例如：003
beneficiaryAddress1	string	收款方地址1(不允许中文)
beneficiaryAddress2	string	收款方地址2(不允许中文)
beneficiaryAddress3	string	收款方地址3：国家/地区 ISO 3166编码
beneficiarySwiftCode	string	银行Swift Code
intermediarySwiftCode	string	中间银行Swift Code
companyCode	string	企业编码
status	int32	状态： 0-处理中 1-成功 2-失败
paymentFiles	Array<FileInfo>	支付证明文件
remark	string	备注

请求示例

{
    "settlementAccountUID":1236547995462114,
    "walletId":4298832316123456,
    "alias":"name alias",
    "accountNumber":"8888888",
    "bankId":"003",
    "beneficiaryAddress1":"payee address1",
    "beneficiaryAddress2":"payee address2",
    "beneficiaryAddress3":"HK",
    "beneficiarySwiftCode":"DHBKHKHHXXX",
    "intermediarySwiftCode":"DHBKHKHHXXX",
    "paymentFiles": [
        {
          "fileKey": "file_key_123",
          "fileName": "证明文件.pdf",
        }
      ],
    "remark": "备注信息"
}

响应示例

{
    "code":1,
    "message":"success",
    "data":{
        "settlementAccountUID":1236547995462114,
        "walletId":4298832316123456,
        "alias":"name alias",
        "accountOwnership":2,
        "currency":"USD",
        "accountType":2,
        "companyName":"narti adiddf",
        "accountNumber":"8888888",
        "bankId":"003",
        "beneficiaryAddress1":"payee address1",
        "beneficiaryAddress2":"payee address2",
        "beneficiaryAddress3":"HK",
        "beneficiarySwiftCode":"DHBKHKHHXXX",
        "intermediarySwiftCode":"DHBKHKHHXXX",
        "companyCode":"HK1239876654",
        "status":0,
        "paymentFiles": [
          {
            "fileKey": "file_key_123",
            "fileName": "证明文件.pdf",
            "fileUrl" "https://xxxxx"
          }
        ],
        "remark": "备注信息"
    }
}

7. 删除收款账号(delBankAccount)

接口概述 删除收款账号 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
settlementAccountUID	int64	是	结算账户标识
reason	string	是	删除原因

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理结果，如 1表示成功，其他值表示不同错误情况
message	string	响应消息，表示操作的结果或错误信息

请求示例

{
    "settlementAccountUID":1236547995462114,
    "walletId":4298832316123456,
    "reason":"del reason"
}

响应示例

{
    "code":1,
    "message":"success"
}

8. 查询收款账号(getBankAccount)

接口概述 查询收款账号 请求参数

参数名	类型	是否必填	描述
walletId	int64	是	钱包 ID
settlementAccountUID	int64	否	结算账户标识
companyCode	string	否	企业编码

响应参数

参数名	类型	描述
code	int32	响应码，表示请求处理结果，如 1表示成功，其他值表示不同错误情况
message	string	响应消息，表示操作的结果或错误信息
data	BankAccountData集合	账户信息

BankAccountData字段说明

参数名	类型	描述
settlementAccountUID	int64	结算账户标识
walletId	int64	钱包 ID
alias	string	别名
accountOwnership	int32	绑定钱包(walletId )关系 1-own account 2-other account
currency	string	币种：USD
accountType	int32	账户类型： 1-RD Wallet 2-Bank Account
companyName	string	公司名称
accountNumber	string	账号，RD Wallet Id or Bank Number
bankId	string	香港银行id，例如：003
beneficiaryAddress1	string	收款方地址1(不允许中文)
beneficiaryAddress2	string	收款方地址2(不允许中文)
beneficiaryAddress3	string	收款方地址3：国家/地区 ISO 3166编码
beneficiarySwiftCode	string	银行Swift Code
intermediarySwiftCode	string	中间银行Swift Code
companyCode	string	企业编码
status	int32	状态： 0-处理中 1-成功 2-失败
paymentFiles	Array<FileInfo>	支付证明文件
remark	string	备注

请求示例

{
    "settlementAccountUID":1236547995462114,
    "walletId":4298832316123456,
    "companyCode":"HK1239876654"
}

响应示例

{
    "code":1,
    "message":"success",
    "data":[{
        "settlementAccountUID":1236547995462114,
        "walletId":4298832316123456,
        "alias":"name alias",
        "accountOwnership":2,
        "currency":"USD",
        "accountType":2,
        "companyName":"narti adiddf",
        "accountNumber":"8888888",
        "bankId":"003",
        "beneficiaryAddress1":"payee address1",
        "beneficiaryAddress2":"payee address2",
        "beneficiaryAddress3":"HK",
        "beneficiarySwiftCode":"DHBKHKHHXXX",
        "intermediarySwiftCode":"DHBKHKHHXXX",
        "companyCode":"HK1239876654",
        "status":0,
        "paymentFiles": [
          {
            "fileKey": "file_key_123",
            "fileName": "证明文件.pdf",
            "fileUrl" "https://xxxxx"
          }
        ],
        "remark": "备注信息"
    }]
}

Callback

1. Callback请求体 (CallbackRequest)

接口概述 回调请求体用于接收服务端回推的业务数据。 请求参数

参数名	类型	是否必填	描述
bizType	OpenBizType	是	业务类型，指定回调的业务类型
data	bytes	是	业务二进制数据，回调中的实际业务内容
clientFingerprint	string	是	客户端证书指纹，用于验证回调请求的客户端身份
serverFingerprint	string	是	服务器证书指纹，用于验证回调请求的服务器身份

OpenBizType 枚举说明

枚举值	描述
_BIZ_TYPE_UNKNOWN	未知的业务类型
ORDER_RESULT_NOTIFICATION	订单结果通知
WHITELIST_RESULT_NOTIFICATION	白名单结果通知
EXCHANGE_BIZ_TYPE_NOTIFICATION	交易业务类型通知
WALLET_OPEN_NOTIFICATION	钱包开户结果通知
COMPANY_APPLICATION_RESULT_NOTIFICATION	企业申请结果通知

请求示例

{
  "bizType":"ORDER_RESULT_NOTIFICATION",
  "data":"base64_encoded_data",
  "clientFingerprint":"client_fingerprint_value",
  "serverFingerprint":"server_fingerprint_value"
}

2. 回调数据类型

2.1 订单结果通知

字段说明

字段名	类型	描述
orderNo	string	订单号
currency	string	币种：USDT/USDC
network	string	区块链网络：ETH/TRX/SOL/POLY
status	string	订单状态
amount	string	金额
fromAddress	string	发起方地址
fromWallet	string	来源钱包
toAddress	string	接收方地址
toWallet	string	目标钱包
txHash	string	交易哈希
orderType	string	订单类型
extOrderNo	string	外部订单号

示例数据

{
  "orderNo":"ORDER123456789",
  "currency":"USDT",
  "network":"ETH",
  "status":"SUCCESS",
  "amount":"1.0",
  "fromAddress":"0x123456789abcdef",
  "toAddress":"0x987654321fedcba",
  "fromWallet":"123456",
  "toWallet":"1234567",
  "txHash":"0x123456789abcdef123456789abcdef",
  "orderType":"TRANSFER",
  "extOrderNo":"EXT123456789"
}

2.2 白名单结果通知

字段说明

字段名	类型	描述
network	string	区块链网络:ETH/TRX/SOL/POLY
address	string	地址
businessType	int32	业务类型: 1-deposit 2-withdraw
status	string	状态: true: 成功 false: 失败

示例数据

{
  "network":"ETH",
  "address":"0x123456789abcdef",
  "businessType":1,
  "status":"true"
}

2.3 钱包开启通知

WalletDetailDto 字段说明

字段名	类型	描述
walletId	int64	钱包 ID
companyName	string	企业名称
companyNameCn	string	中文企业名称
walletStatus	string	钱包开通状态:Success
createTime	string	钱包创建时间
walletType	int32	钱包类型: 1-主钱包 2-子钱包
assets	AssetDto	托管资产列表

AssetDto 字段说明

字段名	类型	描述
network	string	区块链网络：ETH/TRX/SOL/POLY，资产所属的渠道交易资产没有此字段
currency	string	资产的币种：USDT/USDC
totalBalance	string	资产的总余额
availableBalance	string	资产的可用余额
lockBalance	string	资产的锁定余额

请求示例

{
  "walletId":1001
}

响应示例

{
  "code":1,
  "message":"success",
  "data":{
    "walletId":123456789,
    "companyName":"RD Tech",
    "companyNameCn":"圆币科技",
    "walletStatus":1,
    "createTime":"2024-05-20T10:00:00Z",
    "walletType":1,
    "assets":[
      {
        "network":"ETH",
        "address":"0x123456789abcdef",
        "currency":"USDT",
        "balance":"10.0"
      }
    ],
    "exchangeAssets":[
      {
        "address":"0x123456789abcdef",
        "currency":"USDT",
        "balance":"5.0"
      }
    ]
  }
}

2.4 添加收款账号结果通知

字段说明

参数名	类型	描述
settlementAccountUID	int64	结算账户标识
walletId	int64	钱包 ID
alias	string	别名
accountOwnership	int32	和要绑定钱包(walletId )的关系： 1=own account 2=other account
currency	string	币种：USD
accountType	int32	账户类型： 1=RD Wallet 2=Bank Account
accountName	string	账户名称
accountNumber	string	账号，RD Wallet Id or Bank Number
bankId	string	香港银行id，例如：003
beneficiaryAddress1	string	收款方地址1(不允许中文)
beneficiaryAddress2	string	收款方地址2(不允许中文)
beneficiaryAddress3	string	收款方地址3：国家/地区 ISO 3166编码
beneficiarySwiftCode	string	银行Swift Code
intermediarySwiftCode	string	中间银行Swift Code
companyCode	string	企业编码
status	int32	状态： 0-处理中 1-成功 2-失败

示例数据

{
  "settlementAccountUID":1236547995462114,
  "walletId":4298832316123456,
  "alias":"name alias",
  "accountOwnership":2,
  "currency":"USD",
  "accountType":2,
  "accountName":"narti adiddf",
  "accountNumber":"8888888",
  "bankId":"003",
  "beneficiaryAddress1":"payee address1",
  "beneficiaryAddress2":"payee address2",
  "beneficiaryAddress3":"HK",
  "beneficiarySwiftCode":"DHBKHKHHXXX",
  "intermediarySwiftCode":"DHBKHKHHXXX",
  "companyCode":"HK1239876654",
  "status":0
}

2.5 Payout结果通知

字段说明

字段名	类型	描述
walletId	int64	钱包 ID
quoteId	int64	询价 ID
orderNo	string	订单号
fromCurrency	string	币种
fromAmount	Side	金额
toCurrency	string	币种
toAmount	string	金额
tradeFromAmount	string	成交金额
tradeToAmount	string	成交金额
price	string	下单价格
tradePrice	string	成交价格
orderStatus	string	见附录:Payout订单状态
createTime	int64	订单创建时间
finishTime	int64	订单完成时间
errorMsg	string	订单失败原因
settlementAccountUID	int64	结算账户标识
purpose	string	见附录：付款目的(purpose)
paymentWay	string	支付方式：RDT/CHATS
feeMode	int32	手续费扣费模式，默认值：1 1-收付双方共同承担（SHAR） 2-付款方承担所有手续费（OUR)
feeAmount	string	手续费
feeCurrency	string	手续费币种
refundOrderNo	string	Payout订单状态为SETTLING_FAILED有值，用于重新发起结算
extOrderNo	string	业务方订单号（只能是数字、大小写字母_-*且在同一个商户号下唯一）

示例数据

{
     "walletId":1000232233L,
	  "quoteId":665131773713321985
      "orderNo":"442112731049984"
      "fromCurrency":"USDT",
	  "fromAmount":"200.12",
	  "toCurrency":"USD",
      "toAmount":"192.83",
      "tradeFromAmount":"200.12"
      "tradeToAmount":"192.83"
      "price":"1.142"
      "tradePrice":"1.142"
      "orderStatus":"SUCCESSFUL"
      "createTime":1741580889957,
      "finishTime":1741580889957,
      "settlementAccountUID":1236547995462114,
	  "purpose":"GOF",
      "paymentWay":"CHATS",
	  "feeMode":1,
	  "feeAmount":"7",
	  "feeCurrency":"USD",
      "extOrderNo":"1234567898"
}

2.6 Payout退款结果通知

字段说明

字段名	类型	描述
walletId	int64	钱包 ID
orderNo	string	Payout 订单号
refundOrderNo	string	退款订单号
refundAmount	string	实际退款金额
refundCurrency	string	退款币种
refundReason	string	有则回传

示例数据

{
      "walletId":123456789,
      "orderNo":"442112731049984"
      "refundOrderNo":"442112731049984D1"
      "refundAmount":"664.26"
      "refundCurrency":"USD"
      "refundReason":"refund"
      "refundTime":1741580889957
}

2.7 Payout重新结算结果通知

字段说明

字段名	类型	描述
walletId	int64	钱包 ID
orderNo	string	Payout 订单号
refundOrderNo	string	退款订单号
settlementAccountUID	int64	结算账户标识
purpose	string	见附录：付款目的(purpose)
remark	string	描述
paymentWay	string	支付方式：RDT/CHATS	支付方式:RDT/CHATS
feeMode	int32	手续费扣费模式，默认值：1 1:收付双方共同承担（SHAR） 2:付款方承担所有手续费（OUR)
amount	string	结算金额
currency	int64	结算币种
feeAmount	string	手续费
feeCurrency	string	手续费币种

示例数据

{
    "walletId":1000232233L,
	"orderNo":"442112731049984",
	"refundOrderNo":"232112731049984",
	"settlementAccountUID":1236547995462114,
	"purpose":"GOF",
	"remark":"remark",
    "paymentWay":"CHATS",
	"feeMode":1
    "amount":"183",
	"currency":"USD"
	"feeAmount":"7",
	"feeCurrency":"USD"
    "createTime":1741580889957,
    "finishTime":1741580889957,
    "orderStatus":"SUCCESSFUL"
}

2.8 企业申请结果通知

字段说明

字段名	类型	描述
applicationNo	string	RD申请单号
extApplicationNo	string	外部申请单号
applicationCreateTime	int64	申请创建时间（毫秒时间戳）
applicationStatus	string	申请状态: IN_PROGRESS、SUCCESS、FAIL
rejectReason	string	拒绝原因（如果申请被拒绝）
companyCode	string	企业编码
businessType	int32	业务类型： 1-有限公司 2-合伙公司 3-独资公司
incorpPlace	string	公司注册地，如：HKG
ciNumber	string	企业注册证书编号
brNumber	string	商业登记证书编号
incorpDate	string	公司注册日期,格式:yyyy-MM-dd
nameEn	string	企业英文名
nameZh	string	企业本地名（中文名）

示例数据

{
  "applicationNo":"APP20250529001",
  "extApplicationNo":"EXT12345678",
  "applicationCreateTime":1685376000,
  "applicationStatus":"SUCCESS",
  "rejectReason":"",
  "companyCode":"CMP123456",
  "businessType":1,
  "incorpPlace":"HKG",
  "ciNumber":"autoHKL05290010",
  "brNumber":"autoHKL05290010",
  "incorpDate":"2025-05-29",
  "nameEn":"RD Technology Limited",
  "nameZh":"圆币科技有限公司"
}

附录

响应码

代码	描述
1	成功
6001	failed 通用业务失败
6002	parameter error（参数错误）
6003	order not exist (订单不存在)
6004	order duplicate （订单重复）
6005	no permissions（没有权限）
6006	assets not exists（资产不存在）
6101	wallet account not exists（钱包账号不存在）
6102	wallet insufficient fund（钱包余额不足）
6103	wallet status invalid（钱包账号无效）
6104	recipient wallet unavailable （收款钱包不可用）
6105	recipient wallet not exists（收款钱包不存在）
6109	Daily payment limit exceeded (付款日限额不足)
6110	Monthly collection limit exceeded (收款月限额不足)
6301	provider unavailable（通道不可用）
6302	symbol unavailable（币种对不可用）
6303	provider reject（拒绝）
6304	price expire time（价格已过期）
6305	amount lt min amount（金额小于最低限额）
6306	amount gt max amount（金额大于最高限额）
6307	outside of hours（不在交易时间内）
6401	adress already exists地址已存在
6406	processing (请求正在处理)
6801	duplicate request（重复申请）
6802	profile error（资料错误）
6803	reach the max limit（钱包数量达到上限）

上年销售额

code	description（HKD）
1	HKD 50,000,001 或以上
2	HKD 30,000,001-50,000,000
3	HKD 10,000,001-30,000,000
4	HKD 5,000,001 - 10,000,000
5	HKD 2,500,001 - 5,000,000
6	HKD 0 - 2,500,000

经营年限

code	description
1	小于1年
2	1~5年
3	5~10年
4	10年以上

档案错误描述

[Business details]Industry cannot be empty!
[Business details]Added industries exceeded limit: 3
[Business details]Industry code cannot be empty!
[Business details]Industry code does not exist!
[Business details]Sales turnover of last year cannot be empty!
[Business details]Incorrect sales turnover of last year input!
[Business details]Year(s) in business cannot be empty!
[Business details]Incorrect year(s) in business input!
[Business details]Location(s) of business cannot be empty!
[Business details]Location(s) of business exceeded limit: 3
[Business details]Industry details cannot be empty!
[Business details]Industry details exceeded maximum length
[Entity details]We only support partnership business in Hong Kong
[Entity details]We only support sole proprietorship business in Hong Kong
[Entity details]Please enter the ciNumber.
[Entity details]Please enter the brNumber.
[Entity details]Operating place cannot be empty!
[Entity details]Operating address cannot be empty!
[Entity details]Operating address exceeded maximum length
[Entity details]Company registered place cannot be empty!
[Entity details]Company registered place not supported:[区域名称]
[Entity details]Operating place cannot be empty!
[Entity details]The operating place is not supported:[区域名称]
[Entity details]Company registered address cannot be empty!
[Entity details]Company registered address maximum length
[Entity details]Company registered address in English only
[Entity details]Website exceeded maximum length
[Entity details]Incorrect business type!
[Entity details]Business registration certificate number exceeded max length
[Entity details]Business registration certificate number cannot be empty
[Entity details]Certificate of incorporation number exceeded maximum length
[Entity details]Certificate of incorporation number cannot be empty
[Entity details]Name of business in English cannot be empty!
[Entity details]Name of business in Chinese cannot be empty!
[Entity details]Name of business in Chinese exceeded maximum length
[Entity details]Name of business in English exceeded maximum length
[Entity details]Not allowed option
[Entity details]Please upload a valid proof of Certificate of Incorporation
[Entity details]Please upload a valid proof of Memorandum and Articles of Association
[Entity details]Please upload a valid proof of Business Registration
[Entity details]Please upload a valid proof of Partnership Agreement
[Entity details]Please upload a valid proof of Certificate of Incumbency
[Entity details]Please upload a valid proof of KYC Files
[Entity details]Duplicated document
[Entity details]Please enter a valid business type.
[Entity details]Company incorporation date cannot be empty
[Entity details]Company incorporation date cannot be empty be greater than current date:[对应数值]
[Entity details]Place of financial regulator cannot be empty!
[Entity details]Incorrect place of financial regulator input!
[Entity details]Name of regulator cannot be empty!
[Entity details]Name of regulator exceeded maximum length
[Entity details]Type of license cannot be empty!
[Entity details]Type of license exceeded maximum length
[Entity details]Incorrect place of incorporation!
[Entity details]Sorry, the country/region is not supported yet! We are currently unable to serve your business. Please stay tuned, we will support more countries/regions in the future:placeOfIncorporation
[Entity details]We only support partnership business in Hong Kong
[Entity details]We only support sole proprietorship business in Hong Kong
[Entity details]Place of financial regulator cannot be empty!
[Entity details]Incorrect place of financial regulator input!
[Entity details]Name of regulator cannot be empty!
[Entity details]Name of regulator exceeded maximum length
[Entity details]Type of license cannot be empty!
[Entity details]Type of license exceeded maximum length
[Entity details]Please upload a valid proof of License/Certificate of Financial Institution
[Entity details]Place of listing cannot be empty!
[Entity details]Incorrect place of listing input!
[Entity details]Name of exchange cannot be empty!
[Entity details]Name of exchange exceeded maximum length
[Entity details]Stock code cannot be empty!
[Entity details]Stock code exceeded maximum length
[Entity details]Place of government owner cannot be empty!
[Entity details]Incorrect place of government owner input!
[Key people]Email exceeded maximum length
[Key people]Incorrect email address format
[Key people]AreaCode exceeded maximum length
[Key people]MobileNumber exceeded maximum length
[Key people]Incorrect country/region of key people
[Key people]Incorrect country/region and idType of key people
[Key people]Incorrect idType
[Key people]The user’s idv information is incomplete
[Key people]Last name in English exceeded maximum length
[Key people]Last name in English and first name in English cannot have only one value
[Key people]First name in English exceeded maximum length
[Key people]Name in Chinese exceeded maximum length
[Key people]idNumber exceeded maximum length
[Key people]Incorrect gender
[Key people]Please upload a valid proof of key people
[Key people]Please set a valid quorum
[Key people]Id Number[idNumber]was duplicate!
[Key people]Signer must be equal or greater than quorum
[Key people]Direct number has to be between 1 to 99
[Key people]Partner number has to be between 2 to 6
[Key people]Please add at least one owner
[Key people]Please add at most one owner
[Key people]Only limited company can create director
[Key people]Only limited company can create director
[Key people]Only partnership can create partner
[Key people]Please select at least one role for user:
[Key people]IsOwner is only supported by sole proprietorship
[Shareholder]Shareholder structure cannot be empty
[Shareholder]Incorrect Level in sharesholder structure, only Zero to Ten Level
[Shareholder]Last name in English exceeeded maximum length
[Shareholder]First name in English exceeded maximum length
[Shareholder]Name in Chinese exceeded maximum length
[Shareholder]Shareholder (company) name in English exceeded maximum length
[Shareholder]Shareholder (company) name in Chinese exceeded maximum length
[Shareholder]Shareholder (company) RegulatorName exceeded maximum length
[Shareholder]Shareholder (company) ExchangeName exceeded maximum length
[Shareholder]Shareholder (company) Stock code exceeded maximum length
[Shareholder]Incorrect ownedSharesPercent
[Shareholder]Shareholder type cannot be empty
[Shareholder]Please input correct shareholder type:type
[Shareholder]Shareholder (personal) name in English and Chinese cannot be empty at the same time!
[Shareholder]Shareholder (company) name cannot be empty
[Shareholder]Shareholder (company) business type cannot be empty
[Shareholder]Please input correct business type for the shareholder (company):businessType
[Shareholder]We only support sole proprietorship business in Hong Kong
[Shareholder]We only support partnership business in Hong Kong
[Shareholder]Shareholder (company) place of incorporate cannot be empty
[Shareholder]Incorrect shareholder (company) place of incorporate
[Shareholder]We only support company registered place for partnership and sole proprietorship in Hong Kong only
[Shareholder]Last name in English and first name in English cannot have only one value
[Shareholder]ParentId cannot be empty
[Shareholder]Listed/government owner/financial regulator not support partnership business
[Shareholder]Place of financial regulator cannot be empty!
[Shareholder]Place of financial regulator not supported!
[Shareholder]Name of regulator cannot be empty!
[Shareholder]Name of regulator exceeded maximum length
[Shareholder]Type of license cannot be empty!
[Shareholder]Type of license exceeded maximum length
[Shareholder]Listed/government owner not support sole proprietorship business
[Shareholder]Place of listing cannot be empty!
[Shareholder]Place of listing not supported!
[Shareholder]Name of exchange cannot be empty!
[Shareholder]Name of exchange exceeded maximum length
[Shareholder]Stock code cannot be empty!
[Shareholder]Stock code exceeded maximum length
[Shareholder]Place of government owner cannot be empty!
[Shareholder]Incorrect place of government owner input!
[Shareholder]Corresponding shareholder type for sameId[id] is different
[Shareholder]Corresponding shareholder name for sameId[id] is different
[Shareholder]Incorrect parentId in sharesholder structure
[Shareholder]Abnormal shareholder structure
[Shareholder]Shareholder structure cannot exceed 10 layers
[Shareholder]Shareholder structure is not necessary
[Others]Customer type error.

兑换订单状态

代码	描述
SUBMITTED	已提交	订单已提交
CONVERTING	兑换中	订单兑换中
SETTLING	结算中	兑换成功,进行结算
SUCCESSFUL	交易成功	订单处理成功
FAILED	交易失败	订单处理失败

Payout订单状态

代码	描述
SUBMITTED	已提交	订单已提交
CONVERTING	兑换中	订单兑换中
SETTLING	结算中	兑换成功,进行结算
SETTLING_FAILED	结算失败	兑换成功,结算失败
SETTLING_REFUND	退款	结算成功后被退款
SUCCESSFUL	交易成功	订单处理成功
FAILED	交易失败	订单处理失败

入金订单状态

代码	描述
SUBMITTED	已提交	订单已提交
VERIFYING	订单验证	订单提交后,进行安全验证,仅适用于Request Payment
AWAIT_FOR_RECEIVE	等待收款	订单创建成功,等待收款,仅适用于Request Payment
PAYMENT_VERIFYING	收款验证中	平台已收款,进行安全验证,仅适用于Request Payment
AWAIT_FOR_DECLARATION	待补充材料	待补充贸易材料,仅适用于Request Payment
DECLARATION_REVIEW	材料验证中	材料审核中
SUCCESS	交易成功	订单成功
FAILED	交易失败	订单失败
CLOSED	交易关闭	订单到期后关闭
RETURNING	退款中	退款中
RETURNED	已退款	退款处理成功
IN_PROGRESS	收款验证中	平台已收款,进行安全验证,仅适用于Deposit

订单类型

代码	描述
1	Deposit
2	Wallet Transfer
3	Internal Transfer
4	Request Payment
5	Withdraw

字段说明:amount(金额)

该字段用于表示交易金额,类型为字符串,具体精度要求如下:

数币（Digital Currency）:一般支持精确到小数点后最多 6 位,用于满足链上交易的精度需求；
法币（Fiat Currency）:通常保留 最多 2 位小数,即精确到“分”；
日元（JPY）:由于日元为无小数货币,amount应为整数,不允许包含小数部分。

请调用方根据币种类型严格控制金额格式,以避免精度误差或接口处理异常。

付款目的

目的	说明
PMT001	Invoice payments---发票付款
PMT002	Payment for services---服务付款
PMT003	Payment for software---软件付款
PMT004	Payment for imported goods---进口货物付款
PMT005	Travel services---旅行服务
PMT006	Transfer to own account---转账到自己的账户
PMT007	Repayment of loans---贷款偿还
PMT009	Payment of property rental---支付物业租金
PMT010	Information Service Charges---信息服务费
PMT011	Advertising & Public relations-related expenses---广告和公共关系相关费用
PMT012	Royalty fees, trademark fees, patent fees, and copyright fees---版权/商标/专利费用
PMT013	Fees for brokers, front end fee, commitment fee, guarantee fee and custodian fee---经济费、保管费、托管费
PMT014	Fees for advisors, technical assistance, and academic knowledge, including remuneration for specialists---顾问费、技术援助、知识费用等---顾问费、技术援助、知识费用等
PMT015	Representative office expenses---办公室费用
PMT016	Tax Payment---税费
PMT017	Transportation fees for goods---货物运输费用
PMT018	Construction costs/expenses---建筑成本
PMT019	Insurance Premium---保险费
PMT020	General Goods Trades - Offline trade---一般商品贸易
PMT021	Insurance Claims Payment---保险赔付费用
PMT024	Medical Treatment---医疗
PMT025	Donations---捐赠
PMT026	Mutual Fund Investment---投资
PMT027	Currency Exchange---货币兑换
PMT028	Advance Payments for Goods---预付商品款项
PMT029	Merchant Settlement---商户结算
PMT030	Repatriation Fund Settlement---遣返/回国资金结算

快速开始

数币钱包

收单系统

解决方案

​WalletManagementAPI

​1. 文件上传 (FileUpload)

​2. 提交底层客户企业资料 (CreateProfileApplication)

​3. 查询提交申请 (QueryApplication)

​4. 查询企业详情 (QueryCompanyProfile)

​5. 创建子钱包 (CreateSubWallet)

​6. 钱包列表 (WalletList)

​7. 收款地址查询 (ReceiveAddressQuery)

​8. 钱包资产查询 (WalletAssets)

​底层客户资料表单

​合伙公司（香港）

​有限公司（香港）

​有限公司（非香港）

​独资公司（香港/中国大陆）

​WalletPaymentAPI

​1. 钱包转账 (WalletTransfer)

​2. 获取签名 (GetSignData)

​3. 添加地址白名单 (AddAddressWhitelist)

​4. 校验地址白名单 (CheckAddressWhitelist)

​5. 删除地址白名单 (DeleteAddressWhitelist)

​6. 申报收款订单 (DeclareReceiveOrder)

​7. 划拨 (InternalTransfer)

​8. 订单详情 (WalletOrderDetail)

​9. Request Payment订单申报(RequestPaymentOrderDeclare)

​10. Request Payment订单材料补充(AddRequestPaymentMaterials)

​11. 费用查询(feeQuery)

​12. 提现下单(withdraw)

​13. 对账单下载(queryReconBill)

​ConvertAPI

​PayoutModel

​1. 询价(payoutQuote)

​2. 下单(payoutBook)

​3. 订单查询(payoutEnquiry)

​4. 重新结算(payoutReSettle)

​5. 添加收款账号(addBankAccount)

​6. 更新收款账号(updateBankAccount)

​7. 删除收款账号(delBankAccount)

​8. 查询收款账号(getBankAccount)

​Callback

​1. Callback请求体 (CallbackRequest)

​2. 回调数据类型

​2.1 订单结果通知

​2.2 白名单结果通知

​2.3 钱包开启通知

​2.4 添加收款账号结果通知

​2.5 Payout结果通知

​2.6 Payout退款结果通知

​2.7 Payout重新结算结果通知

​2.8 企业申请结果通知

​附录

​响应码

​上年销售额

​经营年限

​档案错误描述

​兑换订单状态

​Payout订单状态

​入金订单状态

​订单类型

​字段说明:amount(金额)

​付款目的

​国家地区编码

​行业编码

WalletManagementAPI

1. 文件上传 (FileUpload)

2. 提交底层客户企业资料 (CreateProfileApplication)

3. 查询提交申请 (QueryApplication)

4. 查询企业详情 (QueryCompanyProfile)

5. 创建子钱包 (CreateSubWallet)

6. 钱包列表 (WalletList)

7. 收款地址查询 (ReceiveAddressQuery)

8. 钱包资产查询 (WalletAssets)

底层客户资料表单

合伙公司（香港）

有限公司（香港）

有限公司（非香港）

独资公司（香港/中国大陆）

WalletPaymentAPI

1. 钱包转账 (WalletTransfer)

2. 获取签名 (GetSignData)

3. 添加地址白名单 (AddAddressWhitelist)

4. 校验地址白名单 (CheckAddressWhitelist)

5. 删除地址白名单 (DeleteAddressWhitelist)

6. 申报收款订单 (DeclareReceiveOrder)

7. 划拨 (InternalTransfer)

8. 订单详情 (WalletOrderDetail)

9. Request Payment订单申报(RequestPaymentOrderDeclare)

10. Request Payment订单材料补充(AddRequestPaymentMaterials)

11. 费用查询(feeQuery)

12. 提现下单(withdraw)

13. 对账单下载(queryReconBill)

ConvertAPI

PayoutModel

1. 询价(payoutQuote)

2. 下单(payoutBook)

3. 订单查询(payoutEnquiry)

4. 重新结算(payoutReSettle)

5. 添加收款账号(addBankAccount)

6. 更新收款账号(updateBankAccount)

7. 删除收款账号(delBankAccount)

8. 查询收款账号(getBankAccount)

Callback

1. Callback请求体 (CallbackRequest)

2. 回调数据类型

2.1 订单结果通知

2.2 白名单结果通知

2.3 钱包开启通知

2.4 添加收款账号结果通知

2.5 Payout结果通知

2.6 Payout退款结果通知

2.7 Payout重新结算结果通知

2.8 企业申请结果通知

附录

响应码

上年销售额

经营年限

档案错误描述

兑换订单状态

Payout订单状态

入金订单状态

订单类型

字段说明:amount(金额)

付款目的

国家地区编码

行业编码