商户提现结果查询

开发环境

http://dev-cn.your-api-server.com

POST

https://developer.toutiao.com/api/apps/ecpay/saas/query_withdraw_order

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

接口说明

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

开发者发起的提现请求，SALT 可以在开发者后台的支付设置中获取。

接口频次

40QPS(小程序app_id维度)

请求示例

服务商模式

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

错误码

错误码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	未查询到服务商与小程序的授权关系	检查服务商与小程序的授权关系

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/saas/query_withdraw_order' \
--header 'Content-Type: application/json' \
--data-raw '{
  "app_id": "tt55ed2350ca8b68ec01",
  "merchant_uid": "M70775300146143419322",
  "channel_type": "alipay",
  "out_order_id": "2022032320105034661545406055",
  "sign": "6ba1cce7bb9b157409f2cb82e72fdd1f"
}'

响应示例

200 - 示例 1

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

请求参数

Header 参数

Content-Type

string

必需

Body 参数application/json

app_id

string

必需

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

merchant_uid

string

必需

进件完成返回的商户号

channel_type

string

必需

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

out_order_id

string

必需

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

sign

string

必需

签名，详见签名DEMO

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

返回码，详见下文错误码

err_tips

string

必需

返回码描述，详见下文错误码

status

string

必需

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

statusMsg

string

状态描述

必需

🟠400请求有误

修改于 2023-12-05 02:15:01

商户提现

商户提现回调

商户提现结果查询

接口说明#

请求示例#

错误码#

请求参数

返回响应

接口说明

请求示例

错误码