开发
API

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

接口功能描述:获取进件页面链接,通过页面提交商户资料,开通商户号以收款或接收分账。

注意事项

  1. 这里的 sub_merchant_id 只是为了便于小程序开发者区分管理,但在分账时用于标识接受方的商户号为接口返回参数中的 merchant_id 字段。

基本信息

请求URL

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

请求方式

POST

接口频次

20QPS(小程序app_id维度)

请求参数

参数

类型

是否必填

最大长度

描述

示例值

sub_merchant_id

string

128

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

71013634663445509434

app_id

string

64

小程序的 app_id

tt226854d5bd56e9ec01

url_type

number

-

链接类型枚举值:

1: 进件页面

2: 账户余额页

1

sign

string

344

签名,详见Demo

1aa1a8100523b3872351956594176a0a0

请求示例

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

响应参数

公共响应参数

参数

类型

是否必填

最大长度

描述

示例值

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

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

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

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