交易汇总对账

  • 请求地址:/trans_rec_sum_query

  • 请求方法:POST

  • 请求字段:

    名称 类型 必填 限制 描述
    version string length >=1 length <=8 版本号,本版本固定填写“2.0”
    sign_type string length >=0 length <=8 签名算法类型,本版本固定为“ECDSA”
    mch_id string length >=1 length <=32 通讯方的ID(即BaaS平台中的机构ID,可在【我的账户】中获取)
    mch_sign string length >=1 length <=256 通讯方签名结果
    chain_id string length >=1 length <=32 链ID
    mch_pubkey string length >=1 length <=64 通讯方公钥(可使用SDK生成,在测试链中:该公钥为用户在BaaS平台【我的账户】中上传的公钥;在专属链中:该公钥为用户在节点管理平台上传的公钥。)
    date string length >=1 length <=32 查询日期
    state int32数组 value >=0 交易状态【当前支持:2,本地已申请,4,已提交;(转让签收场景下:6,已签收;7,已拒签;8,已撤销)】
    trans_type uint64数组 value >=1 交易类型 【当前支持:1,发行;2,转让;3,兑付;4,签收】
    timestamp string length >=0 length <=32 当前unix时间戳(秒),与服务器时间相差过远会返回失败
  • 请求示例:

http://{node_ip:node_port}/trans_rec_sum_query
{
    "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",
    "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 length >=1 length <=8 版本号,本版本固定填写“2.0”
sign_type string length >=1 length <=8 签名算法类型,本版本固定为“ECDSA”
mch_id string length >=1 length <=32 通讯方的ID(即BaaS平台中的机构ID,可在【我的账户】中获取)
mch_sign string length >=1 length <=256 通讯方签名结果
chain_id string length >=1 length <=32 链ID
retcode int32 应答code
retmsg string 应答信息,成功时内容为SUCCESS
date string length >=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 value >=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 交易数量
返回顶部