easywechat4.x升级到6.x

This commit is contained in:
Dev
2026-09-21 14:57:50 +08:00
parent 39882c6cf2
commit 5f4c8147ca
11 changed files with 263 additions and 185 deletions
@@ -2,88 +2,116 @@
namespace app\common\service;
namespace app\common\service;
use EasyWeChat\Factory;
use EasyWeChat\MiniApp\Application as MiniAppApplication;
use EasyWeChat\Pay\Application as PayApplication;
use EasyWeChat\Pay\Message as PayMessage;
use think\Log;
/**
* 微信服务(EasyWeChat 6.x)
* 文档: https://easywechat.com/6.x/
* - 小程序: MiniApp\Application
* - 支付(含回调验签): Pay\Application (微信支付 v3)
*/
class EasyWeChatService
{
public $config;
/** @var MiniAppApplication 小程序实例 */
public $app;
/** @var PayApplication 微信支付 v3 实例 */
public $payApp;
public function __construct()
{
$this->config = config('common.wechat');
$this->app = Factory::miniProgram($this->config);
$this->payApp = Factory::payment($this->config);
// 小程序
$this->app = new MiniAppApplication([
'app_id' => $this->config['app_id'],
'secret' => $this->config['secret'],
'http' => ['throw' => false, 'timeout' => 10.0],
]);
// 微信支付 v3
$this->payApp = new PayApplication([
'mch_id' => $this->config['mch_id'],
'secret_key' => $this->config['secret_key'], // APIv3 密钥
'v2_secret_key' => $this->config['v2_secret_key'], // 旧 v2 密钥(兼容 v2 模式回调)
'private_key' => $this->config['private_key'], // 商户证书私钥
'certificate' => $this->config['certificate'], // 商户API证书
'platform_certs' => $this->config['platform_certs'], // 微信支付公钥/平台证书
'http' => ['throw' => false, 'timeout' => 10.0],
]);
}
/**
* 小程序登录(code2session)
* @param string $code wx.login 获取的 code
* @return array {openid, session_key, unionid?}
*/
public function login($code)
{
$res = $this->app->auth->session($code);
Log::info('login-res' . json_encode([$res]));
$res = $this->app->getUtils()->codeToSession($code);
Log::info('login-res' . json_encode([$res], JSON_UNESCAPED_UNICODE));
return $res;
}
/**
* @param $session
* 解密开放数据(手机号等)
* @param $sessionKey code2session 返回的 session_key
* @param $iv
* @param $encryptedData
* @return array
*/
public function decryData($session, $iv, $encryptedData)
public function decryData($sessionKey, $iv, $encryptedData)
{
$decryptedData = $this->app->encryptor->decryptData($session, $iv, $encryptedData);
return $decryptedData;
return $this->app->getUtils()->decryptSession($sessionKey, $iv, $encryptedData);
}
/**
* 统一下单接口
* @param $body
* @param $out_trade_no
* @param $total_fee float 单位元
* @param $openid
* @param string $notify_url
* @return array|\EasyWeChat\Kernel\Support\Collection|object|\Psr\Http\Message\ResponseInterface|string
* 统一下单(小程序 JSAPI 支付, v3)
* @param string $body 商品描述
* @param string $out_trade_no 商户订单号
* @param float $total_fee 金额(单位:元)
* @param string $openid 支付用户 openid
* @param string $notify_url 支付结果通知地址,留空使用配置默认
* @return array 含 prepay_id;失败时含 message 等错误信息
*/
public function unify($body, $out_trade_no, $total_fee, $openid, $notify_url = '')
{
$params = [
'body' => $body,
'appid' => $this->config['app_id'],
'mchid' => (string)$this->payApp->getMerchant()->getMerchantId(),
'description' => $body,
'out_trade_no' => $out_trade_no,
'total_fee' => $total_fee * 100, //记得转为分
'spbill_create_ip' => '', // 可选,如不传该参数,SDK 将会自动获取相应 IP 地址
'notify_url' => $notify_url ?: null, // 支付结果通知网址,如果不设置则会使用配置里的默认地址
'trade_type' => 'JSAPI', // 请对应换成你的支付方式对应的值类型
'openid' => $openid,
'notify_url' => $notify_url ?: $this->config['notify_url'],
'amount' => ['total' => (int)round($total_fee * 100), 'currency' => 'CNY'], // 转为分
'payer' => ['openid' => $openid],
];
Log::info('unify-params' . json_encode($params));
$result = $this->payApp->order->unify($params);
Log::info('unify-res' . json_encode($result));
Log::info('unify-params' . json_encode($params, JSON_UNESCAPED_UNICODE));
$response = $this->payApp->getClient()->postJson('v3/pay/transactions/jsapi', $params);
$result = $response->toArray(false);
Log::info('unify-res' . json_encode($result, JSON_UNESCAPED_UNICODE));
return $result;
}
/**
* @param $prepayId
* @return array|string
* 小程序调起支付参数(wx.requestPayment)
* @param string $prepayId
* @return array {timeStamp, nonceStr, package, signType, paySign}
*/
public function sdkConfig($prepayId)
{
$jssdk = $this->payApp->jssdk;
$config = $jssdk->bridgeConfig($prepayId, false); // 返回数组
Log::info('bridgeConfig-res' . json_encode($config));
$config = $this->payApp->getUtils()->buildMiniAppConfig($prepayId, $this->config['app_id']);
Log::info('buildMiniAppConfig-res' . json_encode($config, JSON_UNESCAPED_UNICODE));
return $config;
}
/**
* 发送数据消息
* @param $order_id
* 发送小程序订阅消息
* @param $user_id
* @param $template_id
* @param array $msgData
@@ -92,76 +120,127 @@ class EasyWeChatService
{
$data = SubscribeMessageService::packMsg($user_id, $template_id, $msgData);
$res = $this->app->subscribe_message->send($data);
$response = $this->app->getClient()->postJson('/cgi-bin/message/subscribe/send', $data);
$res = $response->toArray(false);
Log::info('发送订阅消息-res' . json_encode(['data' => $data, 'res' => $res], JSON_UNESCAPED_UNICODE));
}
/**
* @param $order_sn
* @param $openid
* @param $name
* @param $amount
* @param $desc
* @return array|mixed
* @throws \Exception
* 商家转账到零钱(v3, 原 v2 企业付款已停用)
* 需在商户平台开通「商家转账」产品权限
* @param string $order_sn 提现单号(字母或数字)
* @param string $openid
* @param string $name 收款用户姓名(商家转账不校验时可留空)
* @param float $amount 金额(单位:元)
* @param string $desc
* @return array {out_batch_no, batch_id, create_time};失败时含 message
*/
public function mchPay($order_sn, $openid, $name, $amount, $desc = '用户提现')
{
$data = [
'partner_trade_no' => $order_sn, // 商户订单号,需保持唯一性(只能是字母或者数字,不能包含有符号)
'openid' => $openid,
'check_name' => 'FORCE_CHECK', // NO_CHECK:不校验真实姓名, FORCE_CHECK:强校验真实姓名
're_user_name' => $name, // 如果 check_name 设置为FORCE_CHECK,则必填用户真实姓名
'amount' => $amount * 100, // 企业付款金额,单位为分
'desc' => $desc, // 企业付款操作说明信息。必填
$params = [
'appid' => $this->config['app_id'],
'out_batch_no' => $order_sn,
'batch_name' => '用户提现',
'batch_remark' => $desc,
'total_amount' => (int)round($amount * 100), // 转为分
'total_num' => 1,
'transfer_detail_list' => [
[
'out_detail_no' => $order_sn . 'D1', // 明细单号(字母数字,保持唯一)
'transfer_amount' => (int)round($amount * 100),
'transfer_remark' => $desc,
'openid' => $openid,
],
],
];
$res = $this->payApp->transfer->toBalance($data);
Log::info('企业付款-res' . json_encode(['data' => $data, 'res' => $res], JSON_UNESCAPED_UNICODE));
Log::info('商家转账-params' . json_encode($params, JSON_UNESCAPED_UNICODE));
$response = $this->payApp->getClient()->postJson('v3/transfer/batches', $params);
$res = $response->toArray(false);
Log::info('商家转账-res' . json_encode($res, JSON_UNESCAPED_UNICODE));
return $res;
}
/**
* @param $apply_sn
* @return array|\EasyWeChat\Kernel\Support\Collection|object|\Psr\Http\Message\ResponseInterface|string
* 查询商家转账批次状态
* @param string $apply_sn 商家转账单号(out_batch_no)
* @return array 转账批次状态及明细
*/
public function queryBalance($apply_sn)
{
$res = $this->payApp->transfer->queryBalanceOrder($apply_sn);
Log::info('企业付款查询-res' . json_encode(['apply_sn' => $apply_sn, 'res' => $res]));
$response = $this->payApp->getClient()->get("v3/transfer/batches/out-batch-no/{$apply_sn}", [
'query' => [
'need_query_detail' => 'true',
'offset' => 0,
'limit' => 20,
'detail_status' => 'ALL',
],
]);
$res = $response->toArray(false);
Log::info('商家转账查询-res' . json_encode(['apply_sn' => $apply_sn, 'res' => $res], JSON_UNESCAPED_UNICODE));
return $res;
}
/**
* @param $order_sn
* @param $refund_no
* @param $actual_amount
* @param $refund_amount
* @param $desc
* @return array|\EasyWeChat\Kernel\Support\Collection|object|\Psr\Http\Message\ResponseInterface|string
* 微信支付退款(v3)
* @param string $order_sn 商户订单号
* @param string $refund_no 商户退款单号
* @param float $actual_amount 原订单金额(单位:元)
* @param float $refund_amount 退款金额(单位:元)
* @param string $desc 退款原因
* @return array
*/
public function refund($order_sn, $refund_no, $actual_amount, $refund_amount, $desc = '出票失败退款')
{
//商户订单号、商户退款单号、订单金额、退款金额、其他参数
$res = $this->payApp->refund->byOutTradeNumber($order_sn, $refund_no, bcmul($actual_amount, 100), bcmul($refund_amount, 100), [
// 可在此处传入其他参数,详细参数见微信支付文档
'refund_desc' => $desc,
]);
Log::info('微信订单退款-res' . json_encode(['param' => func_get_args(), 'res' => $res, [bcmul($actual_amount, 100), bcmul($refund_amount, 100)]]));
$params = [
'out_trade_no' => $order_sn,
'out_refund_no' => $refund_no,
'reason' => $desc,
'amount' => [
'refund' => (int)bcmul($refund_amount, 100), // 转为分
'total' => (int)bcmul($actual_amount, 100),
'currency' => 'CNY',
],
];
Log::info('微信订单退款-params' . json_encode($params, JSON_UNESCAPED_UNICODE));
$response = $this->payApp->getClient()->postJson('v3/refund/domestic/refunds', $params);
$res = $response->toArray(false);
Log::info('微信订单退款-res' . json_encode(['param' => func_get_args(), 'res' => $res], JSON_UNESCAPED_UNICODE));
return $res;
}
/**
* @param $refund_no
* @return array|\EasyWeChat\Kernel\Support\Collection|object|\Psr\Http\Message\ResponseInterface|string
* 查询退款(v3)
* @param string $refund_no 商户退款单号
* @return array
*/
public function refundQuery($refund_no)
{
//商户订单号、商户退款单号、订单金额、退款金额、其他参数
$res = $this->payApp->refund->queryByOutRefundNumber($refund_no);
Log::info('微信订单退款查询-res' . json_encode(['param' => func_get_args(), 'res' => $res]));
$response = $this->payApp->getClient()->get("v3/refund/domestic/refunds/{$refund_no}");
$res = $response->toArray(false);
Log::info('微信订单退款查询-res' . json_encode(['param' => func_get_args(), 'res' => $res], JSON_UNESCAPED_UNICODE));
return $res;
}
/**
* 处理微信支付 v3 回调(验签+解密),返回 PSR-7 响应
* @param \Closure $paidHandler function(PayMessage $message){ 业务处理;异常时抛出则返回失败 }
* @return \Psr\Http\Message\ResponseInterface
*/
public function handlePayNotify(\Closure $paidHandler)
{
$server = $this->payApp->getServer();
$server->handlePaid(function (PayMessage $message, \Closure $next) use ($paidHandler) {
// 回调签名验证(官方推荐,验签失败抛异常 -> serve 返回失败,微信将重试)
$this->payApp->getValidator()->validate($this->payApp->getRequest());
$paidHandler($message);
return $next($message);
});
return $server->serve();
}
}