添加分账接收方API

最新更新时间:2020.04.30 版本说明


1. 电商平台可通过此接口添加分账接收方,建立分账接收方列表。后续通过发起分账请求,将电商平台下的二级商户结算后的资金,分给分账接收方列表中具体的分账接收方。
2. 添加的分账接收方统一都在电商平台维度进行管理,其他二级商户,均可向该分账接收方列表中的接收方进行分账,避免在二级商户维度重复维护。

接口说明

适用对象:电商平台

请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/profitsharing/receivers/add

请求方式:POST

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path指该参数需在请求URL传参

query指该参数需在请求URL传参

body指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
公众账号ID appid string[1,32] body 电商平台的appid(公众号APPID或者小程序APPID)
示例值:wx8888888888888888
接收方类型 type string[1,32] body 分账接收方的类型,枚举值:
MERCHANT_ID:商户
PERSONAL_OPENID:个人
示例值:MERCHANT_ID
接收方账号 account string[1,64] body 分账接收方的账号
类型是MERCHANT_ID时,是商户号
类型是PERSONAL_OPENID时,是个人openid,openid获取方法
示例值:190001001
接收方名称 name string[1,256] 条件选填 body 分账接收方的名称,当type为MERCHANT_ID时,接收方名称是商户全称。
示例值:张三网络公司
接收方名称的密文 encrypted_name string[1,10240] body 1、分账接收方类型是PERSONAL_OPENID时,是个人姓名的密文(选传,传则校验)
此字段的加密的方式为:
2、使用微信支付平台证书中的公钥
3、使用RSAES-OAEP算法进行加密
4、将请求中HTTP头部的Wechatpay-Serial设置为证书序列号
字段加密: 使用APIv3定义的方式加密
示例值:hu89ohu89ohu89o
与分账方的关系类型 relation_type string[1,32] body 子商户与接收方的关系。
枚举值:
SUPPLIER:供应商
DISTRIBUTOR:分销商
SERVICE_PROVIDER:服务商
PLATFORM:平台
OTHERS:其他
示例值:SUPPLIER

请求示例


{
  "appid": "wx8888888888888888",
  "type": "MERCHANT_ID",
  "account": "190001001",
  "name": "张三网络公司",
  "relation_type": "SUPPLIER"
}
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
接收方类型 type string[1,32] 分账接收方的类型,枚举值:
MERCHANT_ID:商户
PERSONAL_OPENID:个人
示例值:MERCHANT_ID
接收方账号 account string[1,64] 分账接收方的账号
类型是MERCHANT_ID时,是商户号
类型是PERSONAL_OPENID时,是个人openid
示例值:190001001

返回示例


200 Response
{
  "type": "MERCHANT_ID",
  "account": "190001001"
}
                                

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 系统异常,请使用相同参数稍后重新调用
400 PARAM_ERROR 请求参数不符合参数格式 请使用正确的参数重新调用
400 INVALID_REQUEST 无效请求 请确认分账接收方是否存在
403 NO_AUTH 商户无权限 请开通商户号分账权限
429 FREQUENCY_LIMITED 添加接收方频率过高 请降低频率后重试

版本说明

关闭
V1.1
2020.04.30
1. 新增appid(公众账号ID)、encrypted_name(接收方名称的密文)字段,接收方类型新增类型:PERSONAL_OPENID:个人
V1.0
2020.03.05
1. 添加分账接收方接口上线

技术咨询

反馈有奖