文档中心 TBaaS 开发指南 Tencent TrustSQL 业务场景接口 交易明细对账

交易明细对账

最近更新时间：2019-10-31 12:15:09

编辑 查看pdf

在这篇文章中：

接口描述

接口名：trans_rec_detail_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 查询日期。
asset_type uint64 数组 是 value ≥ 1 资产类型，例如：0. 商票 1. 数字货币 2. Q币 3. 游戏装备 4. 黄金 5. 积分 6. 卡券 7. 股权。
trans_type int32 数组 是 value ≥ 1 交易类型，当前支持：
1. 发行 2. 转让 3. 兑付 4. 签收。
state int32 数组 是 value ≥ 1 交易状态，当前支持：
2. 本地已申请 4. 已提交
（转让签收场景下：6. 已签收 7. 已拒签 8. 已撤销）。
page_limit int32 是 0 ≤ value ≤ 20 查询条数。
page_no int32 是 value ≥ 1 页数。
timestamp String 是 length ≥ 0 当前 UNIX 时间戳（秒），与服务器时间相差过远会返回失败。

请求示例

{
    "mch_sign": "MEQCIAxrEMfJjRvxTrceK51hnpAr8quHQNnXN2PbZVlg9q/nAiBzlBmWwHlhZi+IRlJzFwmk4xFFRIQD8qKf4e1Cq7vPwA==",
    "version": "2.0",
    "mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
    "timestamp": "1545029614",
    "trans_type": [
        1,
        2
    ],
    "chain_id": "chain_id",
    "node_id": "node_id",
    "page_limit": 20,
    "mch_id": "mch_id",
    "state": [
        4
    ],
    "sign_type": "ECDSA",
    "date": "2018-12-17",
    "asset_type": [
        1
    ],
    "page_no": 10
}

应答示例

{
    "version":"2.0",
    "sign_type":"ECDSA",
    "mch_id":"trust_mch",
    "mch_sign":"MEYCIQC8oSpQck3a3Sv+Q7klyoBJdgZYZqZEoCP4Y6A8/yDqSAIhAN+Bu1SAsyV/CCpuL8NjUGy4tmRygn1HLxQ5Nf5SCGzU",
    "retcode":0,
    "retmsg":"SUCCESS",
    "date":"2018-12-17",
    "trans_list":[
    ],
    "total":18,
    "chain_id":"chain_id",
    "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，可从 账号信息 页面获取。
chain_id String 否 1 ≤ length ≤ 32 网络 ID。
mch_sign String 是 1 ≤ length ≤ 256 通讯方签名结果。
retcode int32 是 - 应答 code，成功时为0。
retmsg String 是 - 应答信息，成功时内容为 SUCCESS。
date String 否 1 ≤ length ≤ 32 查询日期。
trans_list message
数组		 否 - 用户资产信息。
trans_list.trans_hash String 否 0 ≤ length ≤ 64 区块链交易 Fhash 值。
trans_list.transaction_id String 否 1 ≤ length ≤ 32 交易 ID。
trans_list.trans_type int32 否 value ≥ 1 交易类型。
trans_list.trans_state int32 否value ≥ 1 交易状态。
trans_list.src_account String 否 0 ≤ length ≤ 64 资产转出账户。
trans_list.dst_account String 否 0 ≤ length ≤ 64 资产转入账户。
trans_list.src_asset_list String 否 1 ≤ length ≤ 64 资产转出的 ID 列表。
trans_list.dst_asset_id String 否 1 ≤ length ≤ 64 资产转入的 ID。
trans_list.left_asset_id String 否 1 ≤ length ≤ 64 剩余找零资产 ID。
trans_list.dst_amount uint64 否 value ≥ 1 转出到目标账户的资产份额。
trans_list.left_amount uint64 否 value ≥ 1 剩余的资产份额。
trans_list.fee_amount uint64 否 value ≥ 1 手续费份额。
trans_list.extra_info String 否 - 扩展信息。
trans_list.sign_str_list String 否 - 当状态为2/3时，表示 JSON String 格式待签名串。
trans_list.b_height int64 否 value ≥ 0 交易所在的区块的高度。
trans_list.b_time String 否 length ≥ 0 交易所在的区块的创建时间。
trans_list.business int64 否 - 业务类型。
total int32 否 value ≥ 0 交易数量。
mch_pubkey String 是 1 ≤ length ≤ 64 通讯方公钥（支持1.2以上版本）。

TBaaS 相关文档