商户提现
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://open.douyin.com/api/apps/ecpay/saas/merchant_withdraw/
接口说明
错误码
| 错误码err_no | 描述err_msg | 排查建议 |
|---|---|---|
| 0 | 受理成功 | 受理成功 |
| 1000 | 内部错误，请稍后重试 | 稍后重试 |
| 1005 | 频率控制，请稍后重试 | 稍后重试 |
| 1091 | 功能暂未开启 | 功能未开启 |
| 1092 | 幂等，重复请求 | 本次请求的单据已经受理，如果想重新发 起一笔提现，请换单重试。 |
| 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）是否有误 |
| 8000 | 提现因风控被拦截 | 请自查站内信通知或提工单进行咨询 |
| 8001 | 提现余额不足 | 账户余额不足本次提现的金额， 请更换更小的金额 |
| 8002 | 账户状态异常 | 请检查传入的商户号（merchant_uid）在对应渠道（channel_type）是否进件成功 |
| 8003 | 账户状态异常已开通自动提现，不支持商户自行发起提现 | 请检查是否让运营或者产品同学配置了自动提现 |
| 8004 | 提现被风控拦截 | 风控拦截，可提工单进行咨询 |
| 8005 | 渠道结算信息不存在 | 请检查传入的商户号（merchant_uid）对应的结算信息是否有误 |
| 28001008 | access_token过期,请刷新或重新授权 | access_token过期,请根据请求头中token获取方式调用接口重新获取 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.douyin.com/api/apps/ecpay/saas/merchant_withdraw/' \
--header 'access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
"thirdparty_id": "",
"app_id": "tt55ed2350ca8b68ec01",
"merchant_uid": "M70775300146143419322",
"channel_type": "alipay",
"withdraw_amount": 100,
"out_order_id": "2022032320105034661545406055"
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_msg": "string",
"log_id": "string",
"data": {
"order_id": "string",
"merchant_entity": 0
}
}请求参数
Header 参数
Content-Type
string
必需
access-token
string
必需
Body 参数application/json