获取资金账单
收藏接口说明
开发者/服务商可以通过获取资金账单接口查询商户账户资金变动情况
- 账单在次日10点启动生成前一天的对账单，建议商户12点后再获取。
- 资金账单中涉及金额的字段单位为“元”。
- 每月账单一般会在次月 3 号生成，建议商户于次月3号或之后获取对应的月度账单。
- 获取到的文件下载链接过期时间为6小时。
使用限制
接入前，请先查看接入前准备是否完成
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v3/fund/bills/ |
| HTTP Method | POST |
| Scope | trade_basic.developer.trade_bill |
| 权限要求 | 无 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Body
account_type必填String
示例：REFUND_DEPOSIT
账户类型
- FEE:手续费账户
- REFUND_DEPOSIT:退款备用金账户
- PAY_TO_CHANGE:打款到零钱账户
- WX:微信
- ALIPAY:支付宝
- DOUYIN:抖音支付
- YZT:聚合账户
- ALL:所有账户类型
app_id必填String
示例：tt07e3715e98c9aac0
和商户号绑定的 app_id
bill_date必填String
示例：交易完成时间，格式：yyyyMMdd/yyyyMM
交易完成时间
日账单：20220101，
月账单：202201
merchant_id必填String
示例：79825042568385190840
进件完成返回的商户号，商户号可以从以下方式获取
- 通过接口发起进件方式返回的merchant_id
- 通过进件页面链接[开发者获取小程序收款商户/合作方进件页面,服务商获取小程序收款商户进件页面,服务商获取服务商进件页面,服务商获取合作方进件页面]方式返回的merchant_id
- 通过开发者平台支付能力页面查看商户号
payment_type必填String
示例：EXPENDITURE
收支类型
- INCOME:收入
- EXPENDITURE: 支出
- ALL:所有收支类型
trade_type必填String
示例：RECHARGE
交易类型
- RECHARGE:充值
- PAY:打款
- REFUND:退款
- DEAL:交易
- WITHDRAW:提现
- ROLLBACK:退回
- ADJUST_IN: 调账入
- ADJUST_OUT调账出
- PENALTY:扣罚
- SETTLE:分账
- RETURN_SETTLE_IN:退分账入
- RETURN_SETTLE_OUT:退分账出
- ALL:所有交易类型
请求示例
{ "app_id":"ttcfdbb96650e33350", "merchant_id":"72217310113805786153", "account_type":"ALIPAY", "payment_type":"ALL", "trade_type":"SETTLE", "bill_date":"202310" }
响应参数
Body展开全部子属性
err_msg必填String
示例：success
错误提示信息
err_no必填Int32
示例：0
状态码 0 代表业务处理成功，具体错误码参见后文错误码章节
log_id必填String
抖音开平统一日志id
dataStruct
返回数据信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "fund_bill_list": [ "https://developer.toutiao.com/wsos_v2/wallet_open_bill_v3_file/object/wsos656486e7f7c2cb36?expire=1701108747&skipCookie=true&timeStamp=1701087147&sign=b6b41ee67fa35a1sdfsdfsfsdhhhhb380ac770f3c48ec4asdfas60e5" ] }, "err_msg": "", "err_no": 0, "log_id": "20231127201227A1F9E573148674091873" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | success | 成功 |
| 200 | 1000 | 参数解析异常，请检查参数格式 | 请查看参数的格式 |
| 200 | 1006 | post 请求使用 json 传参 | 请将参数改为Json传参，进行重试 |
| 200 | 2010 | 参数错误 | 请使用正确的参数重新调用 |
| 200 | 2000 | 账单文件不存在 | 请确认该商户在指定日期是否有账单文件 |
| 200 | 3203 | 商户号不存在 | 请确认merchant_id，app_id是否正确 |
| 200 | 4000 | 商户号和小程序/应用ID不对应 | 请确认merchant_id是否为app_id下的商户号 |
| 200 | 28001008 | access_token过期,请刷新或重新授权 | access_token过期,请根据请求头中token获取方式调用接口重新获取 |
