商户提现结果查询
收藏我的收藏
收藏开发者/服务商可以通过接口主动查询提现订单状态。
使用限制
无
接口说明
- 服务商发起提现请求，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 | 是 | - | 状态描述 |
响应示例
正常响应示例
{
"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 | 未查询到服务商与小程序的授权关系 | 检查服务商与小程序的授权关系 |
文档评论
