微信商家分账API

普通商户官方文档：https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=26_1
服务商分账API官方文档：https://pay.weixin.qq.com/wiki/doc/api/allocation_sl.php?chapter=24_1&index=1
分账接口问题Q&A：https://developers.weixin.qq.com/community/pay/doc/000284823e8460aada68dacca5b008?blockType=8%3FblockType%3D8%3FblockType%3D8
这个两个分账其实走的接口是一样的（单次分账接口）：https://api.mch.weixin.qq.com/secapi/pay/profitsharing
只是请求时候发送的参数有点差异；主要的差异就是服务商分账多了两个参数：子商户号：sub_mch_id，子商户公众账号ID：sub_appid（非必填）

image.png

image.png

首先梳理一下流程：

1. 先到微信商户平台开通分账此功能，并且设置分账的比例是多少，目前分账比例最多30%
2. 根据业务，确定要走的接口是单次分账还是多次分账
3. 不管走的是单次分账还是多次分账，都需要先走添加分账人这个接口
4. 发生退款时候，需要走分账回退接口

下面开始流程；以普通商户示例：

开通分账流程官方文档有，这里不再叙述，文档接口：https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=26_2

添加分账人接口：https://pay.weixin.qq.com/wiki/doc/api/allocation_sl.php?chapter=25_6&index=2
添加分账人只需要添加一次就通过了就可以了，所以不是很建议每次分账时候都跑一次添加分账人的接口，可以在管理后台设置分账人等信息，保存时候再走添加或者删除分账人的接口

 /**
     * 添加分账接收方
     *
     * @param $account
     * @return array|false
     * @throws Exception
     * @throws \Exception
     */
    public function addReceiver( $account )
    {
        // 1.生成签名
        $receiver = json_encode($account,256|64);
        $postArr = [
            'appid'=>$this->config['appId'],
            'mch_id'=>$this->config['mchId'],
            'nonce_str'=>md5(time() . rand(1000, 9999)),
            'receiver'=>$receiver
        ];
        $wxSign = new WxSign();
        $sign = $wxSign->getSign($postArr, 'HMAC-SHA256',$this->config['md5Key']);
        $postArr['sign'] = $sign;
        Log::info($postArr);

        // 2.发送请求
        $curl = new CUrl();
        $url = 'https://api.mch.weixin.qq.com/pay/profitsharingaddreceiver';
        $postXML = $wxSign->toXml($postArr);

        // 3.处理结果
        $curl_res = $curl->post($url,$postXML);
        $ret = $wxSign->toArray($curl_res);
        return $ret;
    }

添加完分账人之后，就可以走单次或者多次分账的接口，这里我就用单次分账接口示例；接口文档：https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=27_1&index=1

/**
    * 请求单次分账接口
    *
    * @return array
    * @throws Exception
    * @throws \Exception
    */
   public function profitSharing($profitSharingOrder)
   {
     //分账接收方数组
     /*  $receivers = [
           'type' => 'MERCHANT_ID',
           'account' => ‘接收方mchId’,
           'amount' => “分账的金额，一定是整型，单位是分”,  //这里注意不能大过（支付金额*分账比例）之后的金额
           'description' => '分账',  //备注 不可以少
       ];  
   */

      //profitSharingOrder传递的参数
      /* $profitSharingOrder = [
           'sub_mchid' => '接收方的mch_id',
           'transaction_id' => "微信支付订单号",
           'order_no' => “自己生成的订单号”,
           'receivers' => json_encode($receivers,256|64),  //接收方数组  json格式
       ];
     */

       // 2.生成签名
       $postArr = array(
           'appid'=>$this->config['appId'],
           'mch_id'=>$this->config['mchId'],
           'nonce_str'=>md5(time() . rand(1000, 9999)),
           'out_order_no'=>$profitSharingOrder['order_no'],  //自己生成的订单号
           'transaction_id'=>$profitSharingOrder['transaction_id'],  //微信支付订单号
           'receivers'=>$profitSharingOrder['receivers'],  //接收方  json格式
       );

       if( isset($profitSharingOrder['sub_appid']) ) $postArr['sub_appid'] = $profitSharingOrder['sub_appid'];
       $wxSign = new WxSign();
       $sign = $wxSign->getSign($postArr, 'HMAC-SHA256', $this->config['md5Key']);
       $postArr['sign'] = $sign;

       // 3.发送请求
       $curl = new CUrl(2);
       $url = 'https://api.mch.weixin.qq.com/secapi/pay/profitsharing';
       $postXML = $wxSign->toXml($postArr);

       $opts = array(
           CURLOPT_HEADER    => 0,
           CURLOPT_SSL_VERIFYHOST    => false,
           CURLOPT_SSLCERTTYPE   => 'PEM', //默认支持的证书的类型，可以注释
           CURLOPT_SSLCERT   => $this->config['appCertPem'].'apiclient_cert.pem',
           CURLOPT_SSLKEY    => $this->config['appKeyPem'].'apiclient_key.pem',
       );

       // 4.结果
       $curl_res = $curl->setOption($opts)->post($url,$postXML);
       $ret = $wxSign->toArray($curl_res);

       if($ret['return_code']=='SUCCESS' and $ret['result_code']=='SUCCESS'){
           //保存分账订单状态或者别的操作
           return $ret;
       }
       return $ret;
   }

分账如果成功了，会返回success，如果不成功也会返回fail的信息，可以根据信息，到官方问题回复去查询；分账接口问题Q&A：https://developers.weixin.qq.com/community/pay/doc/000284823e8460aada68dacca5b008?blockType=8%3FblockType%3D8%3FblockType%3D8

填坑1：分账需要注意的地方，传递接收方的分账的金额amount时候，微信那边会收取手续费，具体的手续费是多少大家可以去微信平台自己的商户账号里面看下，所以传递分账金额amount的时候，需要减掉手续费，比如手续费是0.2%，设置的分账比例是10%，这分账的金额应该是（支付金额*（10-0.2）%）

image.png

image.png

填坑2，看下图，所以分账接口需要在一分钟之后再分账才能保证成功率

image.png

最后：

总结以上情况，我打包了一套专门用来分账的管理后台，用的laravel框架，管理后台用的laravel-admin，使用了laravel的事件进行监控，有订单回调进来，会隔一分钟后执行分账；

管理平台功能：
基础的权限管理；
分账账号管理；
分账历史记录管理；
分账接收人管理；
有需要的可以私信联系

image.png