## 获取单条交易记录(depositTrade) >[info] 场景说明:获取指定ID的交易记录信息 ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/deposit/trade ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 用户TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | trade\_id | integer | 可选 | 交易ID,交易ID和交易号二者比传其一 | | tradeNo | string | 可选 | 交易号,交易ID和交易号二者比传其一 | | | | | | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "trade_id": 1 } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | data | array | 必须 | 返回结果,如果没有数据则返回空 | 返回`data`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | trade\_id | integer | 必须 | 交易ID | | tradeNo | string | 必须 | 交易号 | | payTradeNo | string | 可选 | 支付交易号,待支付状态的交易该值必填 | | outTradeNo | string | 可选 | 第三方支付平台的订单号 | | bizOrderId | string | 必须 | 商户订单号 | | bizIdentity | string | 必须 | 商户业务类型 | | buyer\_id | integer | 必须 | 交易的买家ID | | seller\_id | integer | 必须 | 交易的卖家ID | | amount | decimal | 必须 | 交易金额 | | status | string | 必须 | 交易状态,取值请参考:[交易状态码](response-code.md) | | payment\_code | string | 必须 | 支付方式代码,取值请参考:[支付方式代码](payment-code.md) | | payment\_name | string | 必须 | 支付方式名称 | | flow | string | 必须 | 资金流向,取值:"income"=收入、"outlay"=支出 | | title | string | 必须 | 交易标题 | | buyer\_remark | string | 可选 | 买家备注 | | seller\_remark | string | 可选 | 卖家备注 | | add\_time | string | 必须 | 交易添加时间,格式:yyyy-mm-dd hh:ii:ss | | pay\_time | string | 可选 | 付款时间,已付款的交易该项必传 | | end\_time | string | 可选 | 完成时间,交易结束该项必传 | | \+ orderInfo | array | 可选 | 订单信息, 如果该交易是购物订单类型(bizIdentity="trade10001),则该项必填 | | └ order\_id | integer | 必须 | 订单ID | | └ order\_sn | string | 必须 | 订单编号 | | └ order\_amount | decimal | 必须 | 订单金额 | | └ orderGoods | OrderGoods | 必须 | 订单商品列表 | 返回`OrderGoods`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | rec\_id | integer | 必须 | 记录ID | | spec\_id | integer | 必须 | 商品规格ID | | goods\_id | integer | 必须 | 商品ID | | goods\_name | string | 必须 | 商品名称 | | goods\_image | string | 必须 | 商品图片 | | specification | string | 必须 | 商品规格组合 | | price | decimal | 必须 | 商品价格 | | quantity | integer | 必须 | 购买数量 | | order\_id | integer | 必须 | 订单ID | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "trade_id": 11, "tradeNo": "20200911105418341468", "outTradeNo": "", "payTradeNo": "20200911111348314202", "bizOrderId": "15997640575344232", "bizIdentity": "trade10001", "buyer_id": 3, "seller_id": 2, "amount": 190.00, "status": "ACCEPTED" "payment_code": "deposit", "payment_name": "余额支付", "flow": "outlay", "title": "支付 - G2000衬衫男长袖防皱商务男装 工作休闲正装衣服修身薄款白色衬衣", "buyer_remark": "", "seller_remark": "", "add_time": "2020-09-11 10:54:18", "pay_time": "2020-09-11 11:13:48", "end_time": "", "orderInfo": { "order_id": 1, "order_sn": "15988070317256892", "order_amount": 1499.00, "orderGoods": [ { "rec_id": 1, "spec_id": 8, "goods_id": 8, "goods_name": "Midea/美的 BCD-213TM(E) 节能静音家用三开门小冰箱小型电冰箱", "goods_image": "http://www.xxx.com/data/files/store_2/goods/20181121212111597.jpg", "specification": "颜色:红色 尺码:L", "price": 1499.00, "quantity": 1, "order_id":1 } ] } } } ```