服务商获取服务商提现页面
收藏我的收藏
收藏
获取账户余额页面链接，通过页面可查询余额及发起提现。
使用限制
无
接口说明
- 资金到账时间取决于银行或渠道的系统处理时效，一般情况下从发起提现到实际到账时间约 1-3 天，请您耐心等待！
基本信息
基本信息 | |
|---|---|
HTTP URL | https://developer.toutiao.com/api/apps/ecpay/saas/add_merchant |
HTTP Method | POST |
接口频次 | 20QPS(thirdparty_component_id维度) |
请求头
名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
Content-Type | string | 是 | 固定值 "application/json" |
请求参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
component_access_token | string | 是 | 64 | 授权码兑换接口调用凭证，链接 | 8011210351 |
thirdparty_component_id | string | 是 | 64 | 小程序第三方平台应用 id | ttc4a8b2155b82682f |
url_type | number | 是 | - | 链接类型枚举值： 2: 账户余额页（可以发起提现） 3: 提现记录页 | 2 |
prod_id | number | 否 | - | 商户号对应的支付解决方案 1：担保支付｜普通版 2：担保支付｜企业版 不传默认为1 | 2 |
请求示例
{ "component_access_token": "08011210351", "thirdparty_component_id": "ttc4a8b2155b82682f", "url_type": 2， "prod_id": 2 }
响应参数
公共响应参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
err_no | number | 是 | - | 返回码，详见错误码 | 2008 |
err_tips | string | 是 | - | 返回码描述，详见错误描述 | 签名校验异常，请使用正确的签名和 json 传参 |
业务响应参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
url | string | 是 | 1024 | 请求页面链接，24小时过期，注意定时更新，请勿长期保存。 | "https://tp-pay.snssdk.com/embed-merchant/status?app_id=ttdb96ad2b44aeff3301" |
merchant_id | string | 是 | 50 | 小程序平台分配商户号，用于支付、分账等环节标识商户 | 69929319333434329240 |
响应示例
业务响应示例
{ "err_no": 0, "err_tips": "", "merchant_id": "69929319333434329240", "url": "https://tp-pay.snssdk.com/embed-merchant/status?app_id=xxx\u0026merchant_id=xxx\u0026sign=3JAOS-KXjFwYybEIYXvdC52DBxESU2ru_d0Cb0wzt7beJdqxj9c3Ig903xfJ4te5o3SGoe2Z_ED7lXrcY3SjIJHdCch7vNaSWLYIG_L7tzEDydESvyV2IcK7IOs6tKlPqzZvaTr1McI_OAZKrhorcrHMspQgcyIEVR6aNW0Cn81N82CS6Nd3hM0QV05tBCkVwimaWOuG7_4PaTzaulgyWw\u0026uid=xxx\u0026uid_type=xxx" }
异常响应示例
{ "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 |
2042 | 小程序appid无效，请检查app_id字段 | 检查appid字段信息是否有误 |
2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
2048 | 未查询到服务商与小程序的授权关系 | 检查服务商和小程序是否有授权关系 |
4000 | 商户号和小程序/应用ID不对应 | 检查app_id和merchant_id是否对应 |
4002 | 有效信息不足，请再次输入 | 请查看自己满足的条件的查询参数是否正确 |
