查询最大分账比例

更新时间:2024.11.05

可调用此接口查询特约商户设置的允许服务商分账的最大比例

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/profitsharing/merchant-configs/{sub_mchid}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json


path 路径参数

sub_mchid  必填 string

【子商户号】微信支付分配的子商户号,即分账的出资商户号。

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/profitsharing/merchant-configs/1900000109 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

sub_mchid  必填 string(32)

【子商户号】参考请求参数


max_ratio  必填 integer

【最大分账比例】子商户允许父商户分账的最大比例,单位万分比,比如2000表示20%

应答示例

200 OK

1{
2  "sub_mchid" : "1900000109",
3  "max_ratio" : 2000
4}
5

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

商户号未设置

请使用正确的参数重新调用

403

NO_AUTH

服务商未开通分账功能

请先开通分账功能

403

NO_AUTH

非服务商下的签约子商户

请先签约子商户

403

NO_AUTH

子商户未开通分账功能

请先开通子商户的分账功能

429

FREQUENCY_LIMITED

商户发起分账查询的频率过高

请降低频率后重试

500

SYSTEM_ERROR

系统错误

系统异常,请使用相同参数稍后重新调用

 

 

反馈
咨询
目录
置顶