开发
API

商户提现

接口功能描述:对可提现账户余额发起提现。

注意事项

  1. 资金到账时间取决于银行或渠道的系统处理时效,一般情况下从发起提现到实际到账时间约 1-3 天,请您耐心等待!
  2. 保证每一笔提现传入 out_order_id 不同。
  3. 这个接口返回的状态码为 0 只代表受理成功,实际提现结果可通过提现查询结果进行查询。
  4. 针对于一个收款商户只允许一天在某一个渠道成功提现 5 次。
  5. 服务商发起提现请求,SALT 可以在第三方平台的设置->开发设置获取。
  6. 开发者发起的提现请求,SALT 可以在开发者后台的支付设置中获取。

接口说明

请求URL

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

请求方式

POST

接口频次

5次/天(merhcant_uid+channel_type维度)

请求头

名称

类型

必填

描述

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

withdraw_amount

number

[0, 2147483647]

提现金额;单位分

100

out_order_id

string

128

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

"withdraw03456"

callback

string

1024

提现结果通知接口(开发者自己的https服务);如果不传默认用支付设置中的回调地址

"https://www.bytedance.com"

cp_extra

string

2048

向开发者回调时,会原样存储在回调参数的extra字段中返回。

"withdraw_demo"

sign

string

344

签名,详见DEMO

cd67804fe6c25fd66a49975cc59ff81b

请求示例

{
  "thirdparty_id": "",
  "app_id": "tt55ed2350ca8b68ec01",
  "merchant_uid": "70775300146143419322",
  "channel_type": "alipay",
  "withdraw_amount": 100,
  "out_order_id": "2022032320105034661545406055",
  "sign": "6ba1cce7bb9b157102f2c382e72fdd11"
}

响应参数

公共响应参数

参数

类型

是否必填

最大长度

描述

示例值

err_no

number

-

返回码,详见下文错误码

2008

err_tips

string

-

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

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

业务响应参数

参数

类型

是否必填

最大长度

描述

示例值

order_id

string

128

平台侧的受理单号

7078192267961368620

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "",
  "order_id": "7078192267961368620"
}

异常响应示例

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

错误码

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

账户状态异常

请联系运营同学

8003

账户状态异常已开通自动提现,不支持商户自行发起提现

请检查是否让运营或者产品同学配置了自动提现

8004

提现被风控拦截

请联系运营同学

8005

渠道结算信息不存在

请检查该渠道是否已经进件

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