开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

商户提现结果查询

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

注意事项

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

接口说明

请求URL

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

请求方式

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

进件完成返回的商户号

70372492301718182840

channel_type

string

32

提现渠道枚举值:

alipay: 支付宝

wx: 微信

hz: 抖音支付

alipay

out_order_id

string

128

外部单号(开发者侧);唯一标识一笔提现请求

"2022032320105034661545406055"

sign

string

344

签名,详见DEMO

cd67804fe6c25fd66a49975cc59ff81b

请求示例

服务商模式

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

开发者模式

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

响应参数

公共响应参数

参数

类型

是否必填

最大长度

描述

示例值

err_no

number

-

返回码,详见下文错误码

2008

err_tips

string

-

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

签名校验异常,请使用正确的签名和 json 传参

业务响应参数

参数

类型

是否必填

最大长度

描述

示例值

status

string

-

状态枚举值:

成功:SUCCESS

失败: FAIL

处理中: PROCESSING

退票: REEXCHANGE

注:

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

SUCCESS

status_msg

string

-

状态描述


响应示例

正常响应示例

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

异常响应示例

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

错误码

err_no

err_tips

解决方案

0

受理成功

受理成功

1000

内部错误,请稍后重试

稍后重试

1005

频率控制,请稍后重试

稍后重试

1091

功能暂未开启

功能未开启

1092


幂等,重复请求

本次请求的单据已经受理,如果想重新发起一笔提现,请换单重试。

2008

签名校验异常,请使用正确的签名和 json 传参

检查请求参数,修改后重试

2010

业务参数处理异常

检查请求参数,修改后重试

2042


小程序appid无效,请检查app_id字段

检查app_id字段信息是否有误

2047


服务商id无效,请检查thirdparty_id字段

检查thirdparty_id字段信息是否有误

2048

未查询到服务商与小程序的授权关系

检查服务商与小程序的授权关系

7007

账户不存在

请联系运营同学

8000

提现因风控被拦截

请联系运营同学

8001

提现余额不足

账户余额不足本次提现的金额, 请更换更小的金额

8002

账户状态异常

请联系运营同学

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助