交易汇总对账

最近更新时间:2019-10-30 10:22:29

接口描述

接口名: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 交易数量。