---
url: "https://pay.weixin.qq.com/doc/v2/merchant/4011941441.md"
title: "接入流程"
doc_id: 4011941441
---

>更新时间：2026.06.10

## 接入流程图

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

    %% 1. 用户支付
    支付用户->>商户系统：分账方: 1. 用户在商户侧使用微信支付进行支付
    商户系统：分账方->>微信支付系统: 2. 带上分账标识参数profit_sharing请求下单并支付
    微信支付系统->>微信支付系统: 此处省去客户端校验支付的流程

    %% 2. 支付结果回调
    微信支付系统-->>商户系统：分账方: 3. 回调支付结果给商户系统

    %% 3. 添加分账接收方
    商户系统：分账方->>微信支付系统: 4. 调用接口添加分账接收方
    Note over 商户系统：分账方,微信支付系统: 添加分账接收方这步只要在申请分账之前进行即可
    微信支付系统-->>商户系统：分账方: 5. 返回添加结果

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

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

## 开发步骤

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

步骤6：在[统一下单API](https://pay.weixin.qq.com/doc/v2/merchant/4011935214.md)、[付款码支付API](https://pay.weixin.qq.com/doc/v2/merchant/4011937125.md)、[委托扣款API](https://pay.weixin.qq.com/doc/v2/merchant/4011986647.md)中上传参数 `profit_sharing`，请求支付。支付完成后，调用[请求单次分账接口](https://pay.weixin.qq.com/doc/v2/merchant/4011941670.md)或[请求多次分账接口](https://pay.weixin.qq.com/doc/v2/merchant/4011983158.md)；

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

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

| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 是否需要分账 | profit\_sharing | 否 | String(16) | Y | Y-是，需要分账<br>N-否，不分账<br>字母要求大写，不传默认不分账 |

说明：

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