pay/includes/vendor/cccyun/wechatpay-sdk/src/ProfitsharingService.php

<?php

namespace WeChatPay;

use Exception;

/**
 * 分账服务类
 * @see https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=26_1
 */
class ProfitsharingService extends BaseService
{
    public function __construct(array $config)
    {
        parent::__construct($config);

        $this->publicParams = [
            'appid'      => $this->appId,
            'mch_id'     => $this->mchId,
            'nonce_str'  => $this->getNonceStr(),
            'sign_type'  => 'HMAC-SHA256',
        ];
        if (!empty($this->subMchId)) {
            $this->publicParams['sub_mch_id'] = $this->subMchId;
        }
        if (!empty($this->subAppId)) {
            $this->publicParams['sub_appid'] = $this->subAppId;
        }
    }

	/**
	 * 添加分账接收方
	 * @param string $account 分账接收方账号
	 * @param string|null $name 用户姓名(填写后校验)
	 * @return mixed
	 * @throws Exception
	 */
    public function addReceiver(string $account, string $name = null)
    {
        $url = 'https://api.mch.weixin.qq.com/pay/profitsharingaddreceiver';
        $receiver = [
            'type' => 'PERSONAL_OPENID',
            'account' => $account,
            'relation_type' => 'SERVICE_PROVIDER'
        ];
        if(!empty($name)) $receiver['name'] = $name;
        $params = [
            'receiver' => json_encode($receiver, JSON_UNESCAPED_UNICODE)
        ];
        return $this->execute($url, $params);
    }

	/**
	 * 删除分账接收方
	 * @param string $account 分账接收方账号
	 * @return mixed
	 * @throws Exception
	 */
    public function deleteReceiver(string $account)
    {
        $url = 'https://api.mch.weixin.qq.com/pay/profitsharingremovereceiver';
        $receiver = [
            'type' => 'PERSONAL_OPENID',
            'account' => $account
        ];
        $params = [
            'receiver' => json_encode($receiver, JSON_UNESCAPED_UNICODE)
        ];
        return $this->execute($url, $params);
    }

	/**
	 * 请求单次分账
	 * @param string $out_order_no 商户分账单号
	 * @param string $transaction_id 微信订单号
	 * @param string $openid 分账接收方账号
	 * @param string $name 用户姓名(填写后校验)
	 * @param int $amount 分账金额(分)
	 * @return mixed {"transaction_id":"微信订单号","out_order_no":"商户分账单号","order_id":"微信分账单号","status":"分账单状态","receivers":""}
	 * @throws Exception
	 */
    public function submit(string $out_order_no, string $transaction_id, string $openid, string $name, int $amount)
    {
        $url = 'https://api.mch.weixin.qq.com/secapi/pay/profitsharing';
        $receiver = [
            'type' => 'PERSONAL_OPENID',
            'account' => $openid,
            'amount' => $amount,
            'description' => '订单分账'
        ];
        if(!empty($name)) $receiver['name'] = $name;
        $params = [
            'out_order_no' => $out_order_no,
            'transaction_id' => $transaction_id,
            'receivers' => json_encode([$receiver], JSON_UNESCAPED_UNICODE)
        ];
        return $this->execute($url, $params, true);
    }

	/**
	 * 查询分账结果
	 * @param string $out_order_no 商户分账单号
	 * @param string $transaction_id 微信订单号
	 * @return mixed {"transaction_id":"微信订单号","out_order_no":"商户分账单号","order_id":"微信分账单号","status":"分账单状态","receivers":""}
	 * @throws Exception
	 */
    public function query(string $out_order_no, string $transaction_id)
    {
        $url = 'https://api.mch.weixin.qq.com/pay/profitsharingquery';
        $params = [
            'out_order_no' => $out_order_no,
            'transaction_id' => $transaction_id
        ];
        return $this->execute($url, $params);
    }

	/**
	 * 解冻剩余资金
	 * @param string $out_order_no 商户分账单号
	 * @param string $transaction_id 微信订单号
	 * @return mixed {"transaction_id":"微信订单号","out_order_no":"商户分账单号","order_id":"微信分账单号"}
	 * @throws Exception
	 */
    public function unfreeze(string $out_order_no, string $transaction_id)
    {
        $url = 'https://api.mch.weixin.qq.com/secapi/pay/profitsharingfinish';
        $params = [
            'out_order_no' => $out_order_no,
            'transaction_id' => $transaction_id,
            'description' => '分账已完成'
        ];
        return $this->execute($url, $params, true);
    }

	/**
	 * 查询订单待分账金额
	 * @param string $transaction_id 微信订单号
	 * @return mixed {"transaction_id":"微信订单号","unsplit_amount":"订单剩余待分金额"}
	 * @throws Exception
	 */
    public function orderAmountQuery(string $transaction_id)
    {
        $url = 'https://api.mch.weixin.qq.com/pay/profitsharingorderamountquery';
        $params = [
            'transaction_id' => $transaction_id,
        ];
        return $this->execute($url, $params);
    }

	/**
	 * 分账回退
	 * @param array $params 请求参数
	 * @return mixed
	 * @throws Exception
	 */
    public function return(array $params)
    {
        $url = 'https://api.mch.weixin.qq.com/secapi/pay/profitsharingreturn';
        if (empty($params['order_id']) && empty($params['out_order_no'])) {
            throw new \InvalidArgumentException('order_id、out_order_no至少填一个');
        }
        if (empty($params['out_return_no'])) {
            throw new \InvalidArgumentException('out_return_no参数不能为空');
        }
        return $this->execute($url, $params, true);
    }

	/**
	 * 分账回退结果查询
	 * @param string $out_return_no
	 * @param string $out_order_no
	 * @return mixed
	 * @throws Exception
	 */
    public function returnQuery(string $out_return_no, string $out_order_no)
    {
        $url = 'https://api.mch.weixin.qq.com/pay/profitsharingreturnquery';
        $params = [
            'out_order_no' => $out_order_no,
            'out_return_no' => $out_return_no
        ];
        return $this->execute($url, $params);
    }

}