服务商获取合作方提现页面
获取账户余额页面链接,通过页面可查询余额及发起提现。
使用限制
无
接口说明
- 1.资金到账时间取决于银行或渠道的系统处理时效,一般情况下从发起提现到实际到账时间约 1-3 天,请您耐心等待!
基本信息
基本信息 | |
HTTP URL | |
HTTP Method | POST |
Scope | trade_basic.developer.merchant_saas |
权限要求 | 不需要用户授权 |
请求头
名称 | 类型 | 必填 | 描述 |
Content-Type | string | 是 | 固定值 "application/json" |
access-token | string | 是 | 请求token,根据是否为服务商调用不同接口 |
请求参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
sub_merchant_id | string | 是 | 128 | 商户 id,用于接入方自行标识并管理进件方。由开发者自行分配管理 | 69560322266147130860 |
thirdparty_id | string | 是 | 64 | 小程序第三方平台应用 id | ttc4a3b2154b83622f |
url_type | number | 是 | - | 链接类型枚举值: 2: 账户余额页(可以发起提现)3: 提现记录页 | 2 |
prod_id | number | 否 | - | 商户号对应的支付解决方案 1:担保支付|普通版 2:担保支付|企业版 不传默认为1 | 2 |
role | number | 否 | | prod_id=2的情况下使用,商户号对应的角色 1:收款商户(可以收款也可以接收分账) 2:商户的合作方(只可以接收分账) 不传默认为2 | 2 |
请求示例
{ "sub_merchant_id": "69560322266147130860", "thirdparty_id": "ttc4a3b2154b83622f", "url_type": 2, "prod_id": 2, "role": 1, }
响应参数
公共响应参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
err_no | int64 | 是 | 状态码 0 代表业务处理成功,具体错误码参见后文错误码章节 | 0 |
err_msg | string | 是 | 错误提示信息 | success |
log_id | string | 是 | 抖音开平统一日志id | |
data | object | 否 | 返回数据信息 |
业务响应参数 data
名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
url | string | 是 | 1024 | 请求页面链接,24小时过期,注意定时更新,请勿长期保存。 | |
merchant_id | string | 是 | 50 | 小程序平台分配商户号,用于支付、分账等环节标识商户 | 69929319273134349240 |
响应示例
正常响应示例
{ "err_no": 0, "err_msg": "", "log_id": "202310061616226C30B180133AE61392D7", "data": { "url": "https://pay-merchant.bytedance.com/embed-merchant/v2/status?app_id=800078773621&mainbody_customize=&merchant_id=1200007877&sign=3JAOS-KXjFwYybEIYXvdC53bHjix9O_LDCuTGsIdlYCJ7KiD1wo73tQO6787CTQIO3B8fkrvo-Lhcew3wbBAvgljWC1UreIYyRSqJ5KdYisjAS6_UYK8PK695lBrZ4usaKi1FsCOXv-sB2t-Y8JP1kHpoPXuP1BKH6QhawQYmI8k67kpBWUsPYbpwM0d8XaQDMT7oqKw9pg5LqkmRc_jBA&uid=70832947030972357482&uid_type=1002", "merchant_id": "70832947030972357482" } }
异常示例
{ "err_no": 28001008, "err_msg": "access_token过期,请刷新或重新授权", "log_id": "202310061616226C30B180133AE61392D7" }
错误码
错误码err_no | 描述err_msg | 排查建议 |
0 | "" | 成功 |
1005 | 参数解析异常,请检查参数格式 | 请查看参数的格式 |
1006 | post 请求使用 json 传参 | 请将参数改为Json传参,进行重试 |
1007 | 参数不合法,请检查参数 | 检查请求参数,修改后重试 |
2008 | token校验异常,请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致 | 请校验请求头中生成token的小程序appid/服务商id和请求参数是否一致 |
2042 | 小程序appid无效,请检查app_id字段 | 检查appid字段信息是否有误 |
2047 | 服务商id无效,请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
2048 | 未查询到服务商与小程序的授权关系 | 检查服务商和小程序是否有授权关系 |
4000 | 商户号和小程序/应用ID不对应 | 检查app_id和merchant_id是否对应 |
4002 | 有效信息不足,请再次输入 | 请查看自己满足的条件的查询参数是否正确 |
28001008 | access_token过期,请刷新或重新授权 | access_token过期,请根据请求头中token获取方式调用接口重新获取 |
