文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯云区块链服务平台 TBaaS

资产兑付提交

最近更新时间：2020-06-01 19:38:12

我的收藏

本页目录：

接口描述

注意
申请和提交要在同一个节点上操作。
接口名：asset_settle_submit 请求方法：POST 请求字段：如下表
名称
类型
必填
限制
描述
version
String
是
1 ≤ length ≤ 8
版本号，此版本固定填写“2.0”。
sign_type
String
是
0 ≤ length ≤ 8
签名算法类型，此版本固定为 “ECDSA”。
mch_id
String
是
1 ≤ length ≤ 32
通讯方的 ID。腾讯云账号的 APPID，可从 账号信息 页面获取。
mch_sign
String
是
1 ≤ length ≤ 256
通讯方签名结果。
chain_id
String
是
1 ≤ length ≤ 32
网络 ID。
node_id
String
是
1 ≤ length ≤ 32
节点 ID。
mch_pubkey
String
是
1 ≤ length ≤ 64
节点公钥。用户可在 TrustSQL 控制台，节点列表的节点公钥处上传。
asset_type
uint64
是
0 ≤ value ≤ 32
资产类型。
transaction_id
String
是
1 ≤ length ≤ 32
唯一标识一次交易的 ID。
sign_list
jsonArray
是
0 ≤ length ≤ 64
原待签名串和签名结果。
sign_list.id
int32
是
-
序号。
sign_list.account
String
是
-
签名账户。
sign_list.sign_str
String
是
-
签名串。
sign_list.sign
String
是
-
签名结果。
timestamp
int64
是
value ≥ 0
当前 UNIX 时间戳（秒），与服务器时间相差过远会返回失败。

请求示例

{
    "mch_sign": "MEQCIGcrT7Zq1om7ZXhkEc6PM3S6xGHYbfvEMkvqQjVWBkRZAiAXwiED+AgaVKIuBvIXRsImQ5sqrXg/a4mcBMX7KW9Ckg==",
    "mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
    "timestamp": "1545028831",
    "sign_list": [
        {
            "account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
            "sign_str": "9cea2cb6e6ec8d191c53c592303fc8aa7fffb820123793f8f81a19b5b0061a9b",
            "id": 1,
            "sign": "MEQCIFvz8HiESkLZBMXsxPkqLwvx8mmNXDPeHYO+3TWcCuNRAiBi4pOGczraU/WGY6hPGDA0QCOpYiKsAwdH6BAo0NDerQ=="
        },
        {
            "account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
            "sign_str": "242f728f366d8a709a7cabfa338c7cbbf104418316f3075fa5bfb8ea17702dcd",
            "id": 2,
            "sign": "MEMCHwCpozD0cDemBXoEe+6UQNmp0mtTYxkMa79IfqxKluwCIDtrdm1dwG7MWSBfRLOd9GXc/vkRu9hwAGUDX7IL5dqn"
        }
    ],
    "chain_id": "chain_id",
    "node_id": "node_id",
    "mch_id": "mch_id",
    "version": "2.0",
    "sign_type": "ECDSA",
    "asset_type": 1,
    "transaction_id": "201812170005782180"
}

应答示例

{
    "version":"2.0",
    "sign_type":"ECDSA",
    "mch_id":"trust_mch",
    "mch_sign":"MEUCIQDerW0+psvroQF7SMHSTCb4k6MV64IXUbulRept6PlApwIgLx4naeI2qgLZzFXtwqz8ioj3JuGUueR7LnupT321k3I=",
    "chain_id":"chain_id",
    "retcode":0,
    "retmsg":"SUCCESS",
    "left_asset_id":"27tMLXDif6mWSMq5BWv4nPDWyQpqNREngrgrWhS4rruc94P",
    "left_asset_amount":757,
    "recycle_account":"1CCD5bsX65Rd96P7kSXb1RJT9etMSQLk8i",
    "trans_hash":"91485df79b0bbcc6957bea2fb1db1831d40f94871277f3dd169b2cd19771aefc",
    "trans_b_height":2586,
    "trans_b_timestamp":1545028876,
    "mch_pubkey":"AjOZgNdnh6y0pH7yYyFts2xUm13wTd6upr/6jXjiHiVW"
}

应答字段解析

名称
类型
必填
限制
描述
version
String
是
1 ≤ length ≤ 8
版本号，此版本固定填写“2.0”。
sign_type
String
是
1 ≤ length ≤ 8
签名算法类型，此版本固定为 “ECDSA”。
mch_id
String
是
1 ≤ length ≤ 32
通讯方的 ID。腾讯云账号的 APPID，可从 账号信息 页面获取。
mch_sign
String
是
1 ≤ length ≤ 256
通讯方签名结果。
chain_id
String
是
1 ≤ length ≤ 32
网络 ID。
retcode
int32
是
-
应答 code，成功时为0。
retmsg
String
是
-
应答信息，成功时内容为 SUCCESS。
left_asset_id
String
否
0 ≤ length ≤ 64
找零的资产 ID。
left_asset_amount
int64
否
value ≥ 0
找零的资产份额。
recycle_account
String
否
0 ≤ length ≤ 32
资产转入回收地址即表示资产被兑付后退出系统。
trans_hash
String
否
0 ≤ length ≤ 64
区块链交易 Fhash 值。
trans_b_height
int64
否
value ≥ 0
区块链交易高度。
trans_b_timestamp
int64
否
value ≥ 0
区块时间。
mch_pubkey
String
是
1 ≤ length ≤ 64
通讯方公钥（支持1.2以上版本）。

中国站
目录