---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4012068033.md"
title: "开发指引"
doc_id: 4012068033
---

>更新时间：2026.06.09

## 1. 接口规则

为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考[APIv3接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081606.md)。

## 2. 开发准备

### 2.1. 搭建和配置开发环境

开发者应当依据自身的编程语言来构建并配置相应的开发环境。

## 3. 快速接入

### 3.1. 业务流程图

```mermaid
sequenceDiagram
rect rgb(255,255,255)
    autonumber
    actor 用户
    participant 商户系统-分账方
    participant 微信支付系统
    actor 分账接收方


        用户->>商户系统-分账方: 用户在商户侧使用微信支付进行支付
        商户系统-分账方->>微信支付系统: 待分账标识参数, 请求下单并支付（profit_sharing）
        微信支付系统->>微信支付系统: 此次省去客户端校验支付流程
        微信支付系统-->>商户系统-分账方: 回调支付结果给商户系统

        商户系统-分账方->>微信支付系统: 调用接口添加分账接收方
        note right of 商户系统-分账方: 添加分账接收方需要在申请分账前进行
        微信支付系统-->>商户系统-分账方: 返回添加结果

        商户系统-分账方->>微信支付系统: 添加分账方成功后请求申请分账
        微信支付系统->>分账接收方: 按照商户需求分账给分账接收方
        微信支付系统->>商户系统-分账方: 返回分账申请结果(非最终分账结果)

        alt 查询分账结果（请求申请分账未收到返回或返回状态不明）
            商户系统-分账方->>微信支付系统: 调用查询分账结果
        end
    end
```

重点步骤说明：

步骤4：商户发起添加分账接收方请求（[添加分账接收方API](https://pay.weixin.qq.com/doc/v3/merchant/4012528995.md))，商户的分账接收方数量上限为2万。若已达到上限，可删除部分未使用的接收方后重新添加。

步骤6：在基础支付中上传参数 `profit_sharing`，请求支付。支付完成后，调用[请求分账接口](https://pay.weixin.qq.com/doc/v3/merchant/4012524936.md)；

步骤7：请求分账接口采用异步处理模式，即在接收到商户请求后，会先受理请求（受理请求返回的结果非最终分账结果）再异步处理，最终的分账结果需要通过[查询分账结果接口](https://pay.weixin.qq.com/doc/v3/merchant/4012525210.md)获取；

步骤8：调用[查询分账结果接口](https://pay.weixin.qq.com/doc/v3/merchant/4012525210.md)，根据 `receivers.result` 判断每个接收方的分账结果，如返回 `CLOSED：已关闭`，可根据返回的 `receivers.fail_reason` 分账失败原因参考[分账失败处理指引](https://pay.weixin.qq.com/doc/v3/merchant/4015505684.md)进行处理。

| 参数名 | 变量 | 类型\[长度限制\] | 必填 | 描述 |
| --- | --- | --- | --- | --- |
| 是否需要分账 | profit\_sharing | boolean | 否 | 是否指定分账，枚举值<br>true：是<br>false：否 |

说明： 实现分账只是在普通支付下单接口中新增了一个分账参数profit\_sharing，其他与普通支付方式完全相同。目前支持付款码支付、JSAPI支付、Native支付、App支付、小程序支付、H5支付、委托代扣。