开发
API

获取对账单

接口功能描述:开发者/服务商可以通过对账单查询接口查询支付、退款、分账、退分账的账单。

注意事项

  1. 账单在次日10点启动生成前一天的对账单,建议商户12点后再获取。
  2. 对账单接口只能下载六个月以内的账单。

接口说明

请求URL

https://developer.toutiao.com/api/apps/bills

请求方式

GET

接口频次

10QPS(商户号merchant_id维度)

请求头

名称

类型

必填

描述

Content-Type

string

固定值 "application/json"

请求参数

参数

类型

是否必填

最大长度

描述

示例值

bill_date

string

8

交易完成时间,格式:yyyyMMdd/yyyyMM

日账单:20220101月账单202201

merchant_id

string

64

商户号

79825042568385190840

bill_type

string

64

账单类型,包括 payment:支付账单, settle:分账账单, refund:退款账单,return退分账账单

payment

app_id

string

64

和商户号绑定的 app_id

tt07e3715e98c9aac0

thirdparty_id

string

64

和商户号绑定的 thirdparty_id

69825042568385190840

sign

string

必选

344

签名,详见请求加签算法,地址

详见DEMO

公共响应参数

参数

类型

是否必填

最大长度

描述

error_no

number

-

返回码,详见错误码

error_tips

string

-

返回码描述,详见错误码描述

错误码

error_no

error_tips

解决方案

1000

系统错误

系统内部异常,请稍后再试

1005

频率控制,请稍后重试

稍后重试

2008

权限异常

请检查本次请求sign生成是否正确

2010

参数错误

请使用正确的参数重新调用

2042


小程序appid无效,请检查app_id字段

检查app_id字段信息是否有误

2047


服务商id无效,请检查thirdparty_id字段

检查thirdparty_id字段信息是否有误

2048

未查询到服务商与小程序的授权关系

检查服务商与小程序的授权关系

7008

账单文件不存在

请确认该商户在指定日期是否有账单文件

响应参数

当请求成功时,数据以表格形式返回。由bill_type决定,目前有支付账单,分账账单,退款账单,退分账账单。

支付账单:

字段名

描述

示例值

序号

账单行数

1

支付时间

指该笔交易的发起支付的时间,格式为yyyy-MM-DD HH:MM:SS

2022-01-01 10:00:00

支付完成时间

指该笔交易的支付成功的时间,格式为yyyy-MM-DD HH:MM:SS

2022-01-01 10:00:00

商户号

字节小程序商户号

70989828933300083644

openId

用户在各个小程序中的唯一标识

gS3TwR4HCPXuxbqs

订单号

商户传入的该笔订单的商户订单号

outtradeno001

平台订单号

字节小程序为该笔订单分配的订单号

4200000008201712143733500001

渠道订单号

渠道为该笔订单分配的订单号

50401010122021000000038202001

订单金额

该笔订单交易金额,单元是元,保留到小数点后2位

8.88

支付方式

实际用户支付方式的类型:支付宝,微信,银行卡

银行卡

支付状态

支付状态枚举值:
SUCCESS:成功 TIMEOUT:超时未支付 PROCESSING:处理中 FAIL:失败

SUCCESS

分账账单:

字段名

描述

示例值

序号

账单行数

1

分账时间

指该笔交易的发起分账时间,格式为yyyy-MM-DD HH:MM:SS

2022-01-01 10:00:00

分账完成时间

指该笔交易的分账完成时间,格式为yyyy-MM-DD HH:MM:SS

2022-01-01 11:00:00

商户号

字节小程序商户号

70989828933300083644

openId

用户在各个小程序中的唯一标识

gS3TwR4HCPXuxbqs

订单号

商户传入的该笔订单的商户订单号

outtradeno001

平台订单号

字节小程序为该笔订单分配的订单号

4200000008201712143733500001

渠道订单号

渠道为该笔订单分配的订单号

50401010122021000000038202001

订单金额

该笔订单交易金额,单元是元,保留到小数点后2位

8.88

支付方式

实际用户支付方式的类型:支付宝,微信,银行卡

银行卡

分账单号

商户传入的该笔订单的分账订单号

outtradeno888

分账状态

标识该笔明细数据的类型:
SUCCESS:成功 FAIL:失败 PROCESSING:处理中

SUCCESS

分账方和分账金额

分账方以及对应的分账金额

商户号61915299511876508290-分成金额(分)7942

软件服务费1

该笔订单技术服务费金额,单元是元,保留到小数点后2位

0.08

软件服务费2

商户与平台约定的抽佣金额,单位是元,保留到小数点后2位

0.08

抽佣金额

该笔订单达人抽佣金额,单元是元,保留到小数点后2位

0.88

渠道分账单号

渠道传入的该笔订单的分账订单号

4200000008201712143733500002

平台分账单号

字节小程序传入的该笔订单的分账订单号

50401010122021000000038202001

退款账单:

字段名

描述

示例值

序号

账单行数

1

退款时间

指该笔交易发起退款成时间,格式为yyyy-MM-DD HH:MM:SS

2022-01-01 10:00:00

商户号

字节小程序商户号

70989828933300083644

openId

用户在各个小程序中的唯一标识

gS3TwR4HCPXuxbqs

订单号

商户传入的该笔订单的商户订单号

outtradeno001

渠道订单号

渠道为该笔订单分配的订单号

50401010122021000000038202001

订单金额

该笔订单交易金额,单元是元,保留到小数点后2位

8.88

支付方式

实际用户支付方式的类型:支付宝,微信,银行卡

银行卡

退款类型

该笔退款发送的阶段,分账前和分账后二种

分账前

退款单号

商户传入的该笔订单的退款单号

out_1650893725629

平台退款单号

字节小程序传入的该笔订单的退款订单号

7090534967599663371

退款状态

标识该笔明细数据的类型:
SUCCESS:成功 FAIL:失败 PROCESSING:处理中

SUCCESS

退款完成时间

指该笔交易的退款成功时间,格式为yyyy-MM-DD HH:MM:SS

2022-01-01 10:01:00

退款金额

该笔订单退款金额,单元是元,保留到小数点后2位

8.88

退款模式

退款的模式:系统退款,强制退款,虚拟退款

系统退款

退分账单:

字段名

描述

示例值

序号

账单行数

1

退分账时间

指该笔交易发起退分账时间,格式为yyyy-MM-DD HH:MM:SS

2022-01-01 10:00:00

订单号

商户传入的该笔订单的商户订单号

outtradeno001

商户号

字节小程序商户号

70989828933300083644

openId

用户在各个小程序中的唯一标识

gS3TwR4HCPXuxbqs

订单金额

该笔订单交易金额,单元是元,保留到小数点后2位

8.88

支付方式

实际用户支付方式的类型:支付宝,微信,银行卡

银行卡

分账单号

标识该笔明细数据的类型:
SUCCESS:成功 FAIL:失败 PROCESSING:处理中

SUCCESS

分账完成时间

指该笔交易退分账完成时间,格式为yyyy-MM-DD HH:MM:SS

2022-01-02 10:00:00

退分账单号

商户传入的该笔订单的退分账单号

MS165270780122336198263

平台退分账单号

字节小程序传入的该笔订单的退分账订单号

7098325749463140613

渠道退分账单号

渠道传入的该笔订单的退分账订单号

401010122021000000038202001

退分账方

退分账方的字节小程序平台商户号

70957210039969241963

退分账金额

该笔订单退分账金额,单元是元,保留到小数点后2位

0.04

退分账完成时间

指该笔交易退分账完成时间,格式为yyyy-MM-DD HH:MM:SS

2022-05-16 21:30:00

请求示例

https://developer.toutiao.com/api/apps/bills?merchant_id=68882720803499563550&bill_type=settle&bill_date=20220526&app_id=ttcfdbb96650e33350&sign=dcd355e392b98739a9d15c7a213a8b38

账单样例

支付账单demo
退款账单demo
分账账单demo
退分账账单demo

异常示例

{
  "err_no": 2010,
  "err_tips": "end_date is before start_date"
}
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助