商户提现结果查询
收藏
我的收藏

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

使用限制

无

接口说明

服务商发起提现请求，SALT 可以在第三方平台的设置->开发设置获取。
开发者发起的提现请求，SALT 可以在开发者后台的支付设置中获取。

基本信息

基本信息
HTTP URL	https://developer.toutiao.com/api/apps/ecpay/saas/query_withdraw_order
HTTP Method	POST
接口频次	40QPS(小程序app_id维度)

请求头

名称	类型	必填	描述
Content-Type	string	是	固定值 "application/json"

请求参数

名称	类型	是否必填	最大长度	描述	示例值
thirdparty_id	string	条件选填	64	小程序第三方平台应用 id。服务商发起提现请求的必填	ttc4a8b2155b82682f
app_id	string	是	64	小程序的 app_id；除服务商为自己提现外，其他情况必填	ttdb96ad2b44aeff3301
merchant_uid	string	是	128	进件完成返回的商户号	M70372492301718182840
channel_type	string	是	32	提现渠道枚举值: alipay: 支付宝 wx: 微信 hz: 抖音支付 yzt: 担保支付企业版聚合账户	alipay
out_order_id	string	是	128	外部单号（开发者侧）；唯一标识一笔提现请求	"2022032320105034661545406055"
sign	string	是	344	签名，详见签名DEMO	cd67804fe6c25fd66a49975cc59ff81b

请求示例

服务商模式

{
  "thirdparty_id": "tta4bad2073b9009c7",
  "app_id": "",
  "merchant_uid": "M70775300146143419322",
  "channel_type": "alipay",
  "out_order_id": "2022032320105034661545406055",
  "sign": "6ba1cce7bb9b157409f2cb82e72fdd1f"
}

开发者模式

{
  "app_id": "tt55ed2350ca8b68ec01",
  "merchant_uid": "M70775300146143419322",
  "channel_type": "alipay",
  "out_order_id": "2022032320105034661545406055",
  "sign": "6ba1cce7bb9b157409f2cb82e72fdd1f"
}

响应参数

公共响应参数

名称	类型	是否必填	最大长度	描述	示例值
err_no	number	是	-	返回码，详见下文错误码	2008
err_tips	string	是	-	返回码描述，详见下文错误码	签名校验异常，请使用正确的签名和 json 传参

业务响应参数

名称	类型	是否必填	最大长度	描述	示例值
status	string	是	-	状态枚举值: 成功:SUCCESS 失败: FAIL 处理中: PROCESSING 退票: REEXCHANGE 注：退票：商户的提现申请请求通过渠道（微信/支付宝/抖音支付）提交给银行处理后，银行返回结果是处理成功，渠道返回给商户提现成功，但间隔一段时间后，银行再次通知渠道处理失败并返还款项给渠道，渠道再将该笔失败款返还至商户在渠道的账户余额中	SUCCESS
statusMsg	string	是	-	状态描述

名称

类型

是否必填

最大长度

描述

示例值

status

string

是

状态枚举值:

成功:SUCCESS

失败: FAIL

处理中: PROCESSING

退票: REEXCHANGE

注：

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

SUCCESS

statusMsg

string

是

状态描述

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "",
  "status": "SUCCESS",
  "statusMsg": ""
}

异常响应示例

{
  "err_no": 2008,
  "err_tips": "签名校验异常，请使用正确的签名和 json 传参",
  "status": "",
  "statusMsg": ""
}

错误码

错误码err_no	描述err_tips	排查建议
0	受理成功	受理成功
1000	内部错误，请稍后重试	稍后重试
1005	频率控制，请稍后重试	稍后重试
1091	功能暂未开启	功能未开启
2008	签名校验异常，请使用正确的签名和 json 传参	请检查参数，详见签名DEMO
2010	业务参数处理异常	检查请求参数，修改后重试
2042	小程序appid无效，请检查app_id字段	检查app_id字段信息是否有误
2047	服务商id无效，请检查thirdparty_id字段	检查thirdparty_id字段信息是否有误
2048	未查询到服务商与小程序的授权关系	检查服务商与小程序的授权关系

下一篇：小程序文档指引

商户提现结果查询收藏我的收藏