商户余额查询
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://open.douyin.com/api/apps/ecpay/saas/query_merchant_balance/
错误码
| 错误码err_no | 描述err_msg | 排查建议 |
|---|---|---|
| 0 | "" | 受理成功 |
| 1000 | 内部错误，请稍后重试 | 稍后重试 |
| 1005 | 频率控制，请稍后重试 | 稍后重试 |
| 1091 | 功能暂未开启 | 功能未开启 |
| 2008 | token校验异常，请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致 | 请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致 |
| 2010 | 业务参数处理异常 | 检查请求参数，修改后重试 |
| 2042 | 小程序appid无效，请检查app_id字段 | 检查app_id字段信息是否有误 |
| 2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
| 2048 | 未查询到服务商与小程序的授权关系 | 检查服务商与小程序的授权关系 |
| 7007 | 账户不存在 | 请检查传入的商户号（merchant_uid）是否有误 |
| 8002 | 账户状态异常 | 请检查传入的商户号（merchant_uid）在对应渠道（channel_type ）是否进件成功 |
| 8005 | 渠道结算信息不存在 | 请检查传入的商户号（merchant_uid），提现渠道(channel_type), 主体标识(merchant_entity)对应的结算信息是否有误 |
| 28001008 | access_token过期,请刷新或重新授权 | access_token过期,请根据请求头中token获取方式调用接口重新获取 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.douyin.com/api/apps/ecpay/saas/query_merchant_balance/' \
--header 'access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
"thirdparty_id": "tta4bad2073b9009c7",
"app_id": "",
"merchant_uid": "M70775300146143419322",
"channel_type": "alipay"
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_msg": "string",
"log_id": "string",
"data": {
"account_info": {
"online_balance": 0,
"withdrawable_balacne": 0,
"freeze_balance": 0
},
"settle_info": {
"settle_type": 0,
"settle_account": "string",
"bankcard_no": "string",
"bank_name": "string"
},
"merchant_entity": 0
}
}请求参数
Header 参数
Content-Type
string
必需
access-token
string
必需
Body 参数application/json