添加分账接收方API

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 指该参数需在请求 JSON 传参

请求参数

变量	类型	必填	参数名/描述/示例值
type	string(32）	是	`接收方类型` `query` 分账接收方的类型, 当前仅支持: MERCHANT_ID(商户号）, 填写微信支付分配的商户号。电商平台系统已默认添加为分账接收方, 无需重复添加
			3008450740201411110007820472
account	string(64）	是	`接收方账号` `query` 分账接收方的账号, 当 type 为 MERCHANT_ID 时, 接收方账号是商户号。
			190001001
name	string(256）	是	`接收方名称` `query` 分账接收方的名称, 当 type 为 MERCHANT_ID 时, 接收方名称是商户全称。
			张三网络公司
relation_type	string(32）	是	`与分账方的关系类型` `query` 子商户与接收方的关系。枚举值: SUPPLIER: 供应商 DISTRIBUTOR: 分销商 SERVICE_PROVIDER: 服务商 OTHERS: 其他
			SUPPLIER

请求示例

{
  "type": "MERCHANT_ID",
  "account": "190001001",
  "name": "张三网络公司",
  "relation_type": "SUPPLIER"
}

返回参数

变量	类型	必填	参数名/描述/示例值
type	string(32）	是	`接收方类型` 分账接收方的类型, 当前仅支持: MERCHANT_ID(商户号）。
			3008450740201411110007820472
account	string(64）	是	`接收方账号` 分账接收方的账号, 当 type 为 MERCHANT_ID 时, 接收方账号是商户号。
			190001001

返回示例

正常示例

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

错误码_{公共错误码}

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

Feedback

Was this page helpful?

很高兴听到！请告诉我们，我们如何才能改善.

很遗憾听到这个消息。请告诉我们，我们如何才能改善.

最后修改 April 12, 2020: 整理文档 (f36b91e)