商户提现结果查询

开发环境

POST

https://open.douyin.com/api/apps/ecpay/saas/query_withdraw_order/

开发者/服务商可以通过接口主动查询提现订单状态。

错误码

错误码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	未查询到服务商与小程序的授权关系	检查服务商与小程序的授权关系
28001008	access_token过期,请刷新或重新授权	access_token过期,请根据请求头中token获取方式调用接口重新获取

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.douyin.com/api/apps/ecpay/saas/query_withdraw_order/' \
--header 'access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "thirdparty_id": "tta4bad2073b9009c7",
  "app_id": "",
  "merchant_uid": "M70775300146143419322",
  "channel_type": "alipay",
  "out_order_id": "2022032320105034661545406055"
}'

响应示例

200 - 示例 1

{
  "err_no": 0,
  "err_msg": "string",
  "log_id": "string",
  "data": {
    "status": "string",
    "statusMsg": "string"
  }
}

请求参数

Header 参数

Content-Type

string

必需

access-token

string

必需

Body 参数application/json

thirdparty_id

string

可选

小程序第三方平台应用 id。服务商发起提现请求的必填

app_id

string

必需

小程序的 app_id；除服务商为自己提现外，其他情况必填

merchant_uid

string

必需

进件完成返回的商户号

channel_type

string

必需

提现渠道枚举值:alipay: 支付宝wx: 微信hz: 抖音支付yzt: 担保支付企业版聚合账户

out_order_id

string

必需

外部单号（开发者侧）；唯一标识一笔提现请求

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

状态码 0 代表业务处理成功，具体错误码参见后文错误码章节

err_msg

string

错误提示信息

必需

log_id

string

必需

抖音开平统一日志id

data

object

返回数据信息

可选

status

string

必需

状态枚举值: 成功:SUCCESS 失败: FAIL 处理中: PROCESSING 退票: REEXCHANGE 注：退票：商户的提现申请请求通过渠道（微信/支付宝/抖音支付）提交给银行处理后，银行返回结果是处理成功，渠道返回给商户提现成功，但间隔一段时间后，银行再次通知渠道处理失败并返还款项给渠道，渠道再将该笔失败款返还至商户在渠道的账户余额中

statusMsg

string

状态描述

必需

🟠400请求有误

修改于 2023-11-30 09:15:21

商户提现

开发者获取小程序收款商户/合作方提现页面

商户提现结果查询

错误码#

请求参数

返回响应

错误码