获取资金账单
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://open.douyin.com/api/apps/v3/fund/bills/
使用限制
接口说明
1.
2.
3.
4.
具体文件格式
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 序号 | 账单行数 | 1 |
| 商户号 | 字节小程序商户号 | 70989828933300083644 |
| 交易单号 | 字节小程序为该笔订单分配的订单号 | 4200000008201712143733500001 |
| 关联订单号 | 商户传入的该笔订单的商户订单号 | normal_test_settle_1661183235701 |
| 账户类型 | 该商户的账户类型 | 支付宝 |
| 交易类型 | 该商户的交易类型 | 分账 |
| 收支金额 | 该笔订单交易金额，单元是元，保留到小数点后2位。+代表收入，-代表支出 | -0.88 |
| 账户金额 | 该笔交易发生后的账户余额，单元是元，保留到小数点后2位 | 8.88 |
| 动账时间 | 指该笔交易的支付成功的时间，格式为yyyy-MM-DD HH:MM:SS | 2022/1/1 10:00 |
| 说明 | 交易描述 | 订单完成后分账 |
错误码
| 错误码err_no | 描述err_msg | 排查建议 |
|---|---|---|
| 0 | "" | 成功 |
| 1000 | 参数解析异常，请检查参数格式 | 请查看参数的格式 |
| 1006 | post 请求使用 json 传参 | 请将参数改为Json传参，进行重试 |
| 2010 | 参数错误 | 请使用正确的参数重新调用 |
| 2000 | 账单文件不存在 | 请确认该商户在指定日期是否有账单文件 |
| 3203 | 商户号不存在 | 请确认merchant_id，app_id是否正确 |
| 4000 | 商户号和小程序/应用ID不对应 | 请确认merchant_id是否为app_id下的商户号 |
| 28001008 | access_token过期,请刷新或重新授权 | access_token过期,请根据请求头中token获取方式调用接口重新获取 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.douyin.com/api/apps/v3/fund/bills/' \
--header 'access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id":"ttcfdbb96650e33350",
"merchant_id":"72217310113805786153",
"account_type":"ALIPAY",
"payment_type":"ALL",
"trade_type":"SETTLE",
"bill_date":"202310"
}'响应示例响应示例
200 - 示例 1
{
"data": {
"fund_bill_list": [
"string"
]
},
"err_msg": "string",
"err_no": 0,
"log_id": "string"
}请求参数
Header 参数
Content-Type
string
必需
access-token
string
必需
Body 参数application/json