PHPackages wander/wepay - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. wander/wepay ActiveLibrary[Payment Processing](/categories/payments) wander/wepay ============ 微信支付v3版 for PHP,支持微信支付v3版商户直连模式（WePay）和服务商模式（WePayPartner） v1.0.4(4y ago)71701MITPHPPHP >=7.1 Since Aug 26Pushed 4y ago1 watchersCompare [ Source](https://github.com/wanderpub/wepay)[ Packagist](https://packagist.org/packages/wander/wepay)[ Docs](https://github.com/wanderpub/wepay.git)[ RSS](/packages/wander-wepay/feed)WikiDiscussions main Synced 6d ago READMEChangelog (1)DependenciesVersions (2)Used By (0) wepay ===== [](#wepay) 微信支付v3版 for PHP --------------- [](#微信支付v3版-for-php) 建议在 PHP7.1 上运行以获取最佳性能； WePay APIv3 SDK for PHP 功能描述 ---- [](#功能描述) - 微信支付v3版--商户直连模式 WePay - 微信支付v3版--服务商模式 WePayPartner - 实现功能一、Order 下单、发起支付、查询订单、回调通知 - 实现功能二、Refund 创建退款订单、退款订单查询、获取退款通知 WePay 是基于官方（v3）接口封装，在做微信开发前，必需先阅读微信官方文档。 - 微信官方文档（商户）： - 微信官方文档（服务商）：[https://pay.weixin.qq.com/wiki/doc/apiv3\_partner/pages/index.shtml](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/pages/index.shtml) 安装使用 ---- [](#安装使用) 1.1 通过 Composer 来管理安装 ``` # 首次安装 composer require wander/wepay # 更新 WePay composer update wander/wepay ``` 1.2 如果不使用 Composer， 可以下载 WePay 并解压到项目中 ``` # 在项目中加载初始化文件 include "您的目录/WePay/include.php"; ``` 2.1 接口实例所需参数 ``` $config = [ // 商户绑定的公众号APPID 'appid' => 'wx97c0e0345878c0000', // 微信商户编号ID 'mch_id' => '1613190000', // 微信商户V3接口密钥 'mch_v3_key' => 'uioman4b6p5rcw189qfvy7zh3ekx0000', // 微信商户证书公钥，支持证书内容或文件路径 'cert_public' => $certPublic, // 微信商户证书私钥，支持证书内容或文件路径 'cert_private' => $certPrivate, // 缓存目录配置（可选，需拥有读写权限） 'cache_path' => '', ]; ``` 3.1 商户直连模式创建订单 ``` try { //商户直连模式 $payment = \WePay\Order::instance($config); // 组装支付参数 $result = $payment->create('jsapi', [ 'appid' => $config['appid'], 'mchid' => $config['mch_id'], 'description' => '商品描述', 'out_trade_no' => date("YmdHis"), 'notify_url' => 'https://wander.pub', 'payer' => ['openid' => 'oUC2e6gByJEShMa_5gDOTz5x0000'], 'amount' => ['total' => 1, 'currency' => 'CNY'], ]); echo ''; echo "\n--- 创建支付参数 ---\n"; var_export($result); } catch (Exception $e) { // 出错啦，处理下吧 echo $e->getMessage() . PHP_EOL; } ``` 服务商模式 ----- [](#服务商模式) 4.1 服务商模式--配置文件 ``` $config = [ 'sp_appid' => 'wx5d65886837ce0000',//服务商APPID 'sp_mchid' => '1613090000',//服务商mchid 'sub_appid' => 'wx97c0e03458780000',//微信子商户编号ID 'sub_mchid' => '1613190000',// 微信子商户mchid 'mch_v3_key' => 'uioman4b6p5rcw189qfvy7zh3ekx0000', 'cert_public' => $certPublic,// 微信商户证书公钥，支持证书内容或文件路径 'cert_private' => $certPrivate// 微信商户证书私钥，支持证书内容或文件路径 'cache_path' => '',// 缓存目录配置（可选，需拥有读写权限） ]; ``` 4.2 服务商模式--创建订单 ``` try { $payment = \WePayPartner\Order::instance($config); // 组装支付参数 $result = $payment->create('jsapi', [ 'sp_appid' => $config['sp_appid'],//服务商应用ID 'sp_mchid' => $config['sp_mchid'],//服务商户号 'sub_appid' => $config['sub_appid'],//子商户应用ID 'sub_mchid' => $config['sub_mchid'],//子商户号 'description' => '商品描述',//商品描述 'attach' => sprintf('{"order_id":%s,"type":1}', 110),//附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用 'notify_url' => 'https://wander.pub',//通知URL必须为直接可访问的URL，不允许携带查询串。 'out_trade_no' => '1222222222',//商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一，详见【商户订单号】。特殊规则：最小字符长度为6 'amount' => ['total'=> 1],//订单总金额，单位为分 'payer' => ['sub_openid' => 'oUC2e6gByJEShMa_5gDOTz5x0000']//用户子标识openid ]); echo ''; echo "\n--- 创建支付参数 ---\n"; var_export($result); } catch (\Exception $exception) { // 出错啦，处理下吧 echo $exception->getMessage() . PHP_EOL; } ``` 开源协议 ---- [](#开源协议) - WePay 基于`MIT`协议发布，任何人可以用在任何地方，不受约束 - WePay 部分代码来自互联网，若有异议，可以联系作者()进行删除 ### Health Score 25 — LowBetter than 37% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community10 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 95.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 1724d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/15603923?v=4)[wanderpub](/maintainers/wanderpub)[@wanderpub](https://github.com/wanderpub) --- Top Contributors [![wander112900](https://avatars.githubusercontent.com/u/3345283?v=4)](https://github.com/wander112900 "wander112900 (22 commits)")[![wanderpub](https://avatars.githubusercontent.com/u/15603923?v=4)](https://github.com/wanderpub "wanderpub (1 commits)") --- Tags wepaywechatpayWePayV3WePayPartnerWeXinPay ### Embed Badge ![Health badge](/badges/wander-wepay/health.svg) ``` [![Health](https://phpackages.com/badges/wander-wepay/health.svg)](https://phpackages.com/packages/wander-wepay) ``` ### Alternatives [wepay/php-sdk WePay APIv2 SDK for PHP 56426.3k1](/packages/wepay-php-sdk)[glennraya/xendivel A Laravel package to easily integrate Xendit payment gateway. It supports credit and debit cards, and e-wallet payments and custom invoices, queued notifications, webhook listeners and more. 412.3k](/packages/glennraya-xendivel)[hyperbolaa/wechatpay 微信支付在laravle5中的封装 471.3k](/packages/hyperbolaa-wechatpay) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)