普通商户官方文档：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（非必填）
首先梳理一下流程：
- 先到微信商户平台开通分账此功能，并且设置分账的比例是多少，目前分账比例最多30%
- 根据业务，确定要走的接口是单次分账还是多次分账
- 不管走的是单次分账还是多次分账，都需要先走添加分账人这个接口
- 发生退款时候，需要走分账回退接口
下面开始流程；以普通商户示例：
开通分账流程官方文档有，这里不再叙述，文档接口：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）%）
填坑2，看下图，所以分账接口需要在一分钟之后再分账才能保证成功率
image.png
最后：
总结以上情况，我打包了一套专门用来分账的管理后台，用的laravel框架，管理后台用的laravel-admin，使用了laravel的事件进行监控，有订单回调进来，会隔一分钟后执行分账；
管理平台功能：
基础的权限管理；
分账账号管理；
分账历史记录管理；
分账接收人管理；
有需要的可以私信联系
image.png