微信商家分账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
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,734评论 6 505
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,931评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,133评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,532评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,585评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,462评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,262评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,153评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,587评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,792评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,919评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,635评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,237评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,855评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,983评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,048评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,864评论 2 354