腾讯云区块链服务平台 TBaaS
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯云区块链服务平台 TBaaS

交易汇总对账

最近更新时间：2020-06-01 19:35:05

我的收藏

本页目录：

接口描述

接口名：trans_rec_sum_query 请求方法：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 控制台，节点列表的节点公钥处上传。
date
String
是
1 ≤ length ≤ 32
查询日期。
state
int32 数组
是
value ≥ 0
交易状态，当前支持：2. 本地已申请 4. 已提交（转让签收场景下：6. 已签收 7. 已拒签 8. 已撤销）。
trans_type
uint64 数组
是
value ≥ 1
交易类型，当前支持：1. 发行 2. 转让 3. 兑付 4. 签收。
timestamp
String
是
0 ≤ length ≤ 32
当前 UNIX 时间戳（秒），与服务器时间相差过远会返回失败。

请求示例

{
    "mch_sign":"MEQCIBAEy8sqQbzc76Yfn91mNZn3V5/vyJoYH4odODNNvx8TAiAtBr0TBaQ4/Atx3DIh+d/+AjbYdEuh1y2XryCmXQM2Sw==",
    "mch_pubkey":"A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
    "timestamp":"1535951204",
    "trans_type":[
        1,
        2
    ],
    "state":[
        2,
        4
    ],
    "chain_id":"chain_id",
    "node_id": "node_id",
    "mch_id":"mch_id",
    "version":"2.0",
    "sign_type":"ECDSA",
    "date":"2018-08-30"
}

应答示例

{
    "version":"2.0",
    "sign_type":"ECDSA",
    "mch_id":"trust_mch",
    "mch_sign":"MEYCIQDcYSpF2HWrP4MkYTjAmv4Ss8YY3vPx3wJ7k0Cw31UHMgIhALKiKmkwO75eSUKpMQBxkS/s8KC2oB4hNFOwdgBnB/LT",
    "retcode":0,
    "retmsg":"SUCCESS",
    "date":"2018-08-30",
    "trans_list":[
        {
            "trans_type":1,
            "state":2,
            "count":10,
            "dst_amt":49368,
            "fee_amt":0,
            "left_amt":0
        },
        {
            "trans_type":2,
            "state":2,
            "count":16,
            "dst_amt":138564,
            "fee_amt":26,
            "left_amt":6
        },
        {
            "trans_type":1,
            "state":4,
            "count":219,
            "dst_amt":1101264,
            "fee_amt":0,
            "left_amt":0
        },
        {
            "trans_type":2,
            "state":4,
            "count":19,
            "dst_amt":164993,
            "fee_amt":20,
            "left_amt":18
        }
    ],
    "total":4,
    "chain_id":"chain_id"
}

应答字段解析

名称
类型
必填
限制
描述
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。
date
String
否
1 ≤ length ≤ 32
查询日期。
trans_list
message 数组
否
-
交易信息汇总列表。
trans_list.trans_type
int32
否
value ≥ 1
交易类型。
trans_list.state
int32
否
value ≥ 0
交易状态。
trans_list.count
int64
否
value ≥ 0
交易总笔数。
trans_list.amount
int64
否
value ≥ 0
交易总额度。
trans_list.asset_type
uint64
否
1 ≤ value ≤ 32
资产类型。
trans_list.dst_amt
int64
否
value ≥ 0
交易总额度。
trans_list.fee_amt
int64
否
value ≥ 0
交易总额度。
trans_list.left_amt
int64
否
value ≥ 0
交易总额度。
total
int32
否
value ≥ 0
交易数量。

中国站