获取交易账单
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
GET
https://developer.toutiao.com/api/apps/bills
接口说明
1.
2.
3.
4.
公共响应参数
| 名称 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| error_no | number | 是 | - | 返回码，详见错误码 |
| error_tips | string | 是 | - | 返回码描述，详见错误码描述 |
响应参数
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 序号 | 账单行数 | 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：成功 | SUCCESS |
| 下单poiid | 下单时候的poiid(2023-09-01之后账单才有) | 7082385191204816937 |
| spu商品名称 | 下单时候的商品名称(2023-09-01之后账单才有) | xx-套餐 |
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 序号 | 账单行数 | 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：成功 | SUCCESS |
| 分账方和分账金额 | 分账方以及对应的分账金额 | 商户号61915299511876508290-分成金额(分)7942 |
| 软件服务费1 | 该笔订单技术服务费金额，单元是元，保留到小数点后2位，收费规则详见分账-收费规则-技术服务费 | 0.08 |
| 软件服务费2 | 商户与平台约定的抽佣金额，单位是元，保留到小数点后2位，收费规则详见分账-收费规则-本地生活类软件服务费 | 0.08 |
| 抽佣金额 | 该笔订单达人抽佣金额，单元是元，保留到小数点后2位，佣金计算规则详见分账-收费规则-达人佣金 | 0.88 |
| 渠道分账单号 | 渠道传入的该笔订单的分账订单号 | 4200000008201712143733500002 |
| 平台分账单号 | 字节小程序传入的该笔订单的分账订单号 | 50401010122021000000038202001 |
| 核销poiid | 核销时候的poiid(2023-09-01之后账单才有) | 7082385191204816937 |
| spu商品名称 | 下单时候的商品名称(2023-09-01之后账单才有) | xx-套餐 |
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 序号 | 账单行数 | 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：成功 | SUCCESS |
| 退款完成时间 | 指该笔交易的退款成功时间，格式为yyyy-MM-DD HH:MM:SS | 2022-01-01 10:01:00 |
| 退款金额 | 该笔订单退款金额，单元是元，保留到小数点后2位 | 8.88 |
| 退款模式 | 退款的模式:系统退款,强制退款,虚拟退款 | 系统退款 |
| 退款出资方 | 退款资金来源:商户出资,平台出资 | 商户出资 |
| 下单poiid | 下单时候的poiid(2023-09-01之后账单才有) | 7082385191204816937 |
| 核销poiid | 核销时候的poiid(2023-09-01之后账单才有) | 7082385191204816937 |
| spu商品名称 | 下单时候的商品名称(2023-09-01之后账单才有) | xx-套餐 |
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 序号 | 账单行数 | 1 |
| 退分账时间 | 指该笔交易发起退分账时间，格式为yyyy-MM-DD HH:MM:SS | 2022-01-01 10:00:00 |
| 订单号 | 商户传入的该笔订单的商户订单号 | outtradeno001 |
| 商户号 | 字节小程序商户号 | 70989828933300083644 |
| openId | 用户在各个小程序中的唯一标识 | gS3TwR4HCPXuxbqs |
| 订单金额 | 该笔订单交易金额，单元是元，保留到小数点后2位 | 8.88 |
| 支付方式 | 实际用户支付方式的类型:支付宝，微信，银行卡 | 银行卡 |
| 分账单号 | 标识该笔明细数据的类型： SUCCESS：成功 | 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 |
| 退分账状态 | 标识该笔明细数据的类型： SUCCESS：成功 | SUCCESS |
| 退分账说明 | 指该笔交易退分账时说明 | 支付服务费退回 |
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 序号 | 账单行数 | 1 |
| 小程序 | 字节小程序ID | tt53a7251acc9eb0c401 |
| 商户号 | 字节小程序商户号 | 70258209527390231420 |
| 提现请求号 | 商户传入的该笔提现请求的订单号 | 35cc5576-efdd-9296-08434aaca90a |
| 提现渠道 | 该笔提现订单对应的提现渠道 | 微信支付 |
| 结算账户 | 该笔提现订单对应的结算账户 | 171152179 |
| 结算卡名称 | 该笔提现订单对应的结算银行支行名称 | 中国民生银行股份有限公司南昌县支行 |
| 提现时间 | 指该笔提现发起时间，格式为yyyy-MM-DD HH:MM:SS | 2022-05-16 21:30:00 |
| 提现金额 | 该笔订单提现金额，单元是元，保留到小数点后2位 | 8.88 |
| 提现状态 | 标识该笔提现状态： SUCCESS：成功 | SUCCESS |
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 序号 | 账单行数 | 1 |
| 商户号 | 字节小程序商户号 | 70258209527390231420 |
| 返佣单号 | 字节小程序为该批次返佣生成的返佣单号 | 7116566787457567013 |
| 返佣总金额 | 该批次返佣的总金额，单元是元，保留到小数点后2位 | 8.88 |
| 返佣周期 | 该批次返佣对应的返佣周期，格式yyyy-mm | 2022-06 |
| 返佣类型 | 该批次返佣对应的返佣类型，返佣类型枚举有：标准返佣(指本地生活商户标准返佣)，退佣(指支付后结算商户已退款订单退佣) | 标准返佣 |
| 返佣状态 | 该批次返佣状态 | 结算成功 |
| 抽佣单号 | 该单笔字节小程序生成的抽佣单号 | 7114750668228806946 |
| 单笔抽佣金额 | 该单笔订单抽佣金额，单元是元，保留到小数点后2位 | 1.88 |
| 单笔返佣金额 | 该单笔订单返佣金额，单元是元，保留到小数点后2位 | 0.73 |
| 抽佣时间 | 指该单笔订单抽佣发起时间，格式为yyyy-MM-DD HH:MM:SS | 2022-05-16 21:30:00 |
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 序号 | 账单行数 | 1 |
| 商户号 | 字节小程序商户号 | 69720360030915648360 |
| 返佣单号 | 字节小程序为该批次返佣生成的返佣单号 | 7117247528378075406 |
| 返佣总金额 | 该批次返佣的总金额，单元是元，保留到小数点后2位 | 0.46 |
| 返佣周期 | 该批次返佣对应的返佣周期，格式yyyy-mm | 2022-06 |
| 返佣类型 | 该批次返佣对应的返佣类型，返佣类型枚举有：年框返佣(指本地生活年框商户返佣) | 年框返佣 |
| 返佣状态 | 该批次返佣状态 | 结算成功 |
| 累计GMV(万) | 该商户累计的GMV，单位是万元 | 175 |
| 返佣比例 | 对该商户返佣的百分比 | 60% |
| 累计抽佣金额(元) | 累计抽佣金额，单元是元，保留到小数点后2位 | 4.76 |
| 累计返佣金额(元) | 累计返佣金额，单元是元，保留到小数点后2位 | 2.38 |
| 剩余应返佣金额(元) | 剩余应返佣金额，单元是元，保留到小数点后2位 | 0.46 |
错误码
| 错误码err_no | 描述err_tips | 排查建议 |
|---|---|---|
| 1000 | 系统错误 | 系统内部异常，请稍后再试 |
| 1005 | 频率控制，请稍后重试 | 稍后重试 |
| 2008 | 权限异常 | 请检查签名参数，详见签名DEMO |
| 2010 | 参数错误 | 请使用正确的参数重新调用 |
| 2042 | 小程序appid无效，请检查app_id字段 | 检查app_id字段信息是否有误 |
| 2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
| 2048 | 未查询到服务商与小程 序的授权关系 | 检查服务商与小程序的授权关系 |
| 7008 | 账单文件不存在 | 请确认该商户在指定日期是否有账单文件 |
账单样例
请求参数
Header 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://developer.toutiao.com/api/apps/bills' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"bill_date": "string",
"merchant_id": "string",
"bill_type": "string",
"app_id": "string",
"sign": "string"
}'响应示例响应示例
{
"err_no": 0,
"err_tips": "string"
}修改于 2023-12-05 02:21:40