微信支付-开发者文档

返回上一层文档首页 / 添加分账接收方API

添加分账接收方API

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

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

适用对象：电商平台

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

请求方式：POST

path指该参数为路径参数

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