开发
API

开发者获取小程序收款商户/合作方提现页面

接口功能描述:获取账户余额页面链接,通过页面可查询余额及发起提现。

注意事项

  1. 资金到账时间取决于银行或渠道的系统处理时效,一般情况下从发起提现到实际到账时间约 1-3 天,请您耐心等待!

请求URL

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

请求方式

POST

接口频次

20QPS(小程序app_id维度)

名称

类型

必填

描述

Content-Type

string

固定值 "application/json"

请求参数

参数

类型

是否必填

最大长度

描述

示例值

sub_merchant_id

string

128

商户 id,用于接入方自行标识并管理进件方。由开发者自行分配管理

71013634663445509434

app_id

string

64

小程序的 app_id

tt226854d5bd56e9ec01

url_type

number

-

链接类型枚举值:

2:账户余额页

3:提现记录页

2

sign

string

344

签名,详见Demo

1aa1a8100523b3872351956594176a0a0

{
  "sign": "1aa1a8100523b3872351956594176a0a0",
  "sub_merchant_id": "71013634663445509434",
  "app_id": "tt226854d5bd56e9ec01",
  "url_type": 2
}

参数

类型

是否必填

最大长度

描述

示例值

err_no

number

-

返回码,详见错误码

2008

err_tips

string

-

返回描述,详见错误描述

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

参数

类型

是否必填

最大长度

描述

示例值

url

string

1024

请求页面链接,两小时过期,注意定时更新,请勿长期保存。

"https://tp-pay.snssdk.com/embed-merchant/status?app_id=ttdb96ad2b44aeff3301"

merchant_id

string

50

小程序平台分配商户号,用于后续分账标识分账方。进件完成后,才会有非空返回

71034289132712668623

{
  "err_no": 0,
  "err_tips": "",
  "url": "https://pay-merchant.bytedance.com/embed-merchant/v2/status?app_id=800078773621&mainbody_customize=&merchant_id=1200007877&sign=3JAOS-KXjFwYybEIYXvdC53bHjix9O_LDCuTGsIdlYBXrjP7SYh6kGi6LoaTRieLBFhykj2lqfAl2QYfe30HWqPoHFas2SEn6YTS-jEEDVrXaW8N2pp2HKr41zIglNYw5tot2r6BN7zDQhkt2vL7AUewZG0JYOIKMd-tVeY1zvgYuoLpECyPmB3JrMqMru__mlZ24J2l9rp81tLPw97YZQ&uid=71034289144707668623&uid_type=1002",
  "merchant_id": "71034289132712668623"
}
{
  "err_no": 2008,
  "err_tips": "签名校验异常,请使用正确的签名和 json 传参",
  "merchant_id": "",
  "url": ""
}

err_no

err_tips

解决方案

0

""

成功

1

服务商无对应小程序分账授权

检查当前app_id是否有权限管理

2

网络异常,请稍后重试

稍等原参数重试

1005

参数解析异常,请检查参数格式

请查看参数的格式

1006

post 请求使用 json 传参

请将参数改为Json传参,进行重试

1007

参数不合法,请检查参数

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

2008

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

请参考加签Demo

4000

商户号和小程序/应用ID不对应

检查app_id和merchant_id是否对应

4002

有效信息不足,请再次输入

请查看自己满足的条件的查询参数是否正确

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