开发
API

担保交易账单查询

商户可以通过该接口查看担保交易历史账单,进行账单校对。

请求地址

GET https://developer.toutiao.com/api/apps/bill

请求签名

请求需要签名,详见签名使用

请求参数

属性数据类型必填说明
start_datestring开始时间,格式:20210603
end_datestring结束时间,格式:20210603
sellerstring商户号
bill_typestring账单类型,包括 payment:支付账单, settle:分账账单, refund:退款账单
app_idstring和商户号绑定的 appid 或者 thirdparty_id
signstring对上面的参数进行签名

返回值

当请求成功时,数据以表格形式返回,第一行为各列字段名,根据请求的账单类型不同而不同,由bill_type决定,目前有支付账单,分账账单,退款账单。

支付账单:

序号, 支付时间, 商户号, openId, 订单号, 平台订单号, 渠道订单号, 订单金额, 支付方式, 支付状态

分账账单:

序号, 分账时间, 商户号, openId, 订单号, 平台订单号, 渠道订单号, 订单金额, 支付方式, 分账单号, 分账状态, 分账方和分账金额, 技术服务费, 抽佣金额

退款账单:

序号, 退款时间, 商户号, openId, 订单号, 渠道订单号, 订单金额, 支付方式, 退款类型, 退款单号, 平台退款单号, 退款状态, 退款完成时间, 退款金额

第二行起,为数据记录

序号支付时间商户号openId订单号平台订单号渠道订单号订单金额支付方式支付状态

errCode

当请求失败时,会返回非 0 的 err_no,错误信息会携带在 err_tips 中,错误码含义如下:

错误号描述
1参数错误
-1系统错误

请求示例

https://developer.toutiao.com/api/apps/bill?start_date=20210604&end_date=20210603&seller=xxx&bill_type=settle&app_id=xx&sign=****

返回示例

错误返回

{
  "err_no": 1,
  "err_tips": "end_date is before start_date"
}
点击纠错
评价此篇文档