商户提现结果查询
收藏接口说明
- 开发者/服务商可以通过接口主动查询提现订单状态。
使用限制
无
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/ecpay/saas/query_withdraw_order/ |
| HTTP Method | POST |
| Scope | trade_basic.developer.payment_withdraw |
| 权限要求 | 商户接口提现结果查询 |
请求参数
请求头
access-token必填String
当非服务商时，调用https://open.douyin.com/oauth/client_token/生成的token
当服务商时，调用https://open.douyin.com/openapi/v2/auth/tp/token/生成的token
当服务商时，调用https://open.douyin.com/openapi/v2/auth/tp/token/生成的token
content-type必填String
示例：application/json
固定值"application/json"
Body
app_id必填String
示例：ttdb96ad2b44aeff3301
小程序的 app_id；除服务商为自己提现外，其他情况必填
channel_type必填String
示例：alipay
提现渠道枚举值:
- alipay: 支付宝
- wx: 微信
- hz: 抖音支付
- yzt: 担保支付企业版聚合账户
merchant_uid必填String
示例：M70372492301718182840
进件完成返回的商户号，商户号可以从以下方式获取
- 通过接口发起进件方式返回的merchant_id
- 通过进件页面链接[开发者获取小程序收款商户/合作方进件页面,服务商获取小程序收款商户进件页面,服务商获取服务商进件页面,服务商获取合作方进件页面]方式返回的merchant_id
- 通过开发者平台支付能力页面查看商户号
out_order_id必填String
示例：2022032320105034661545406055
外部单号（开发者侧）；唯一标识一笔提现请求
thirdparty_idString
示例：ttc4a8b2155b82682f
小程序第三方平台应用 id。服务商发起提现请求的必填
请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/ecpay/saas/query_withdraw_order/' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \ --data '{"app_id":"muZ1VMqAPI","thirdparty_id":"xm7y4FwfC9","merchant_uid":"q9tDlgJ5RE","out_order_id":"UVzIT2f6hN","channel_type":"Ex3gDC2rGD"}'
响应参数
Body展开全部子属性
err_msg必填String
示例：success
错误提示信息
err_no必填Int32
示例：0
状态码 0 代表业务处理成功，具体错误码参见后文错误码章节
log_id必填String
示例：抖音开平统一日志id
dataStruct
返回数据信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "", "log_id": "202310061616226C30B180133AE61392D7", "data": { "status": "SUCCESS", "statusMsg": "" } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | 受理成功 | 受理成功 |
| 200 | 1000 | 内部错误，请稍后重试 | 稍后重试 |
| 200 | 1005 | 频率控制，请稍后重试 | 稍后重试 |
| 200 | 1091 | 功能暂未开启 | 功能未开启 |
| 200 | 2008 | token校验异常，请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致 | 请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致 |
| 200 | 2010 | 业务参数处理异常 | 检查请求参数，修改后重试 |
| 200 | 2042 | 小程序appid无效，请检查app_id字段 | 检查app_id字段信息是否有误 |
| 200 | 2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
| 200 | 2048 | 未查询到服务商与 小程序的授权关系 | 检查服务商与小程序的授权关系 |
| 200 | 28001008 | access_token过期,请刷新或重新授权 | access_token过期,请根据请求头中token获取方式调用接口重新获取 |
