商户提现
收藏我的收藏
收藏
对可提现账户余额发起提现。
使用限制
无
接口说明
- 资金到账时间取决于银行或渠道的系统处理时效，一般情况下从发起提现到实际到账时间约 1-3 天，请您耐心等待！
- 保证每一笔提现传入 out_order_id 不同。
- 这个接口返回的状态码为 0 只代表受理成功，实际提现结果可通过提现查询结果进行查询。
- 针对于一个收款商户只允许一天在某一个渠道成功提现 5 次。
- 服务商发起提现请求，SALT 可以在第三方平台的设置->开发设置获取。
- 开发者发起的提现请求，SALT 可以在开发者后台的支付设置中获取。
基本信息
基本信息 | |
|---|---|
HTTP URL | https://developer.toutiao.com/api/apps/ecpay/saas/merchant_withdraw |
HTTP Method | 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 | 进件完成返回的商户号 | M70372492301718182840 |
channel_type | string | 是 | 32 | 提现渠道枚举值: alipay: 支付宝 wx: 微信 hz: 抖音支付 yeepay: 易宝 yzt: 担保支付企业版聚合账户 | 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" |
merchant_entity | number | 否 | - | 抖音信息和光合信号标识: 不传或传0或1 按抖音信息提现；传2按光合信号提现。 注意：channel_type为yzt时需要传2 | 1 |
sign | string | 是 | 344 | 签名，详见签名DEMO | cd67804fe6c25fd66a49975cc59ff81b |
请求示例
{ "thirdparty_id": "", "app_id": "tt55ed2350ca8b68ec01", "merchant_uid": "M70775300146143419322", "channel_type": "alipay", "withdraw_amount": 100, "out_order_id": "2022032320105034661545406055", "sign": "6ba1cce7bb9b157102f2c382e72fdd11" }
响应参数
公共响应参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
err_no | number | 是 | - | 返回码，详见下文错误码 | 2008 |
err_tips | string | 是 | - | 返回码描述,详见下文错误码 | 签名校验异常，请使用正确的签名和 json 传参 |
业务响应参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
order_id | string | 是 | 128 | 平台侧的受理单号 | N7078192267961368620 |
merchant_entity | number | 是 | - | 抖音信息和光合信号标识 1: 抖音信息提现 2: 光合信号提现 | 1 |
响应示例
正常响应示例
{ "err_no": 0, "err_tips": "", "order_id": "N7078192267961368620", "merchant_entity": 1 }
异常响应示例
{ "err_no": 2008, "err_tips": "签名校验异常，请使用正确的签名和 json 传参", "order_id": "" }
错误码
错误码err_no | 描述err_tips | 排查建议 |
|---|---|---|
0 | 受理成功 | 受理成功 |
1000 | 内部错误，请稍后重试 | 稍后重试 |
1005 | 频率控制，请稍后重试 | 稍后重试 |
1091 | 功能暂未开启 | 功能未开启 |
1092 | 幂等，重复请求 | 本次请求的单据已经受理，如果想重新发起一笔提现，请换单重试。 |
2008 | 签名校验异常，请使用正确的签名和 json 传参 | 请检查参数，详见签名DEMO |
2010 | 业务参数处理异常 | 检查请求参数，修改后重试 |
2042 | 小程序appid无效，请检查app_id字段 | 检查app_id字段信息是否有误 |
2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
2048 | 未查询到服务商与小程序的授权关系 | 检查服务商与小程序的授权关系 |
7007 | 账户不存在 | 请检查传入的商户号（merchant_uid）是否有误 |
8000 | 提现因风控被拦截 | 请自查站内信通知或提工单进行咨询 |
8001 | 提现余额不足 | 账户余额不足本次提现的金额， 请更换更小的金额 |
8002 | 账户状态异常 | 请检查传入的商户号（merchant_uid）在对应渠道（channel_type）是否进件成功 |
8003 | 账户状态异常已开通自动提现，不支持商户自行发起提现 | 请检查是否让运营或者产品同学配置了自动提现 |
8004 | 提现被风控拦截 | 风控拦截，可提工单进行咨询 |
8005 | 渠道结算信息不存在 | 请检查传入的商户号（merchant_uid）对应的结算信息是否有误 |
