普通商戶官方文檔：https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=26_1
服務(wù)商分賬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
只是請求時候發(fā)送的參數(shù)有點差異；主要的差異就是服務(wù)商分賬多了兩個參數(shù)：子商戶號：sub_mch_id，子商戶公眾賬號ID：sub_appid（非必填）
首先梳理一下流程：
- 先到微信商戶平臺開通分賬此功能，并且設(shè)置分賬的比例是多少，目前分賬比例最多30%
- 根據(jù)業(yè)務(wù)，確定要走的接口是單次分賬還是多次分賬
- 不管走的是單次分賬還是多次分賬，都需要先走添加分賬人這個接口
- 發(fā)生退款時候，需要走分賬回退接口
下面開始流程；以普通商戶示例：
開通分賬流程官方文檔有，這里不再敘述，文檔接口：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
添加分賬人只需要添加一次就通過了就可以了，所以不是很建議每次分賬時候都跑一次添加分賬人的接口，可以在管理后臺設(shè)置分賬人等信息，保存時候再走添加或者刪除分賬人的接口
/**
* 添加分賬接收方
*
* @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.發(fā)送請求
$curl = new CUrl();
$url = 'https://api.mch.weixin.qq.com/pay/profitsharingaddreceiver';
$postXML = $wxSign->toXml($postArr);
// 3.處理結(jié)果
$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)
{
//分賬接收方數(shù)組
/* $receivers = [
'type' => 'MERCHANT_ID',
'account' => ‘接收方mchId’,
'amount' => “分賬的金額，一定是整型，單位是分”, //這里注意不能大過（支付金額*分賬比例）之后的金額
'description' => '分賬', //備注 不可以少
];
*/
//profitSharingOrder傳遞的參數(shù)
/* $profitSharingOrder = [
'sub_mchid' => '接收方的mch_id',
'transaction_id' => "微信支付訂單號",
'order_no' => “自己生成的訂單號”,
'receivers' => json_encode($receivers,256|64), //接收方數(shù)組 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.發(fā)送請求
$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', //默認(rèn)支持的證書的類型，可以注釋
CURLOPT_SSLCERT => $this->config['appCertPem'].'apiclient_cert.pem',
CURLOPT_SSLKEY => $this->config['appKeyPem'].'apiclient_key.pem',
);
// 4.結(jié)果
$curl_res = $curl->setOption($opts)->post($url,$postXML);
$ret = $wxSign->toArray($curl_res);
if($ret['return_code']=='SUCCESS' and $ret['result_code']=='SUCCESS'){
//保存分賬訂單狀態(tài)或者別的操作
return $ret;
}
return $ret;
}
分賬如果成功了，會返回success，如果不成功也會返回fail的信息，可以根據(jù)信息，到官方問題回復(fù)去查詢；分賬接口問題Q&A：https://developers.weixin.qq.com/community/pay/doc/000284823e8460aada68dacca5b008?blockType=8%3FblockType%3D8%3FblockType%3D8
填坑1：分賬需要注意的地方，傳遞接收方的分賬的金額amount時候，微信那邊會收取手續(xù)費，具體的手續(xù)費是多少大家可以去微信平臺自己的商戶賬號里面看下，所以傳遞分賬金額amount的時候，需要減掉手續(xù)費，比如手續(xù)費是0.2%，設(shè)置的分賬比例是10%，這分賬的金額應(yīng)該是（支付金額*（10-0.2）%）
填坑2，看下圖，所以分賬接口需要在一分鐘之后再分賬才能保證成功率
image.png
最后：
總結(jié)以上情況，我打包了一套專門用來分賬的管理后臺，用的laravel框架，管理后臺用的laravel-admin，使用了laravel的事件進行監(jiān)控，有訂單回調(diào)進來，會隔一分鐘后執(zhí)行分賬；
管理平臺功能：
基礎(chǔ)的權(quán)限管理；
分賬賬號管理；
分賬歷史記錄管理；
分賬接收人管理；
有需要的可以私信聯(lián)系
image.png
