PHPackages ibrand/pay - 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. ibrand/pay ActiveLibrary[Payment Processing](/categories/payments) ibrand/pay ========== ibrand pay component v0.2.5(5y ago)1316.0k↓37.5%2[1 issues](https://github.com/guojiangclub/pay/issues)1MITPHPPHP >=7.0CI failing Since Nov 20Pushed 4y ago2 watchersCompare [ Source](https://github.com/guojiangclub/pay)[ Packagist](https://packagist.org/packages/ibrand/pay)[ RSS](/packages/ibrand-pay/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependencies (6)Versions (11)Used By (1) 做成 Laravel 中最傻瓜式的微信、支付宝支付扩展包 ============================ [](#做成-laravel-中最傻瓜式的微信支付宝支付扩展包) Feature ------- [](#feature) 1. 实现多渠道支付方式，如：原生支付，pingxx支付，银商支付等。 2. 实现多业务统一支付。 3. 实现异步通知统一封装。 TODO: ----- [](#todo) 1. 实现退款 安装 -- [](#安装) ``` $ composer require ibrand/pay $ php artisan vendor:publish $ php artisan migrate ``` 使用 -- [](#使用) ### 创建支付请求 [](#创建支付请求) 发起一次支付请求时需要创建一个新的 charge 对象，获取一个可用的支付凭据用于客户端向第三方渠道发起支付请求。 ``` use iBrand\Component\Pay\Facades\Charge; $charge = Charge::create(['channel' => 'wx_lite' , 'order_no' => $order_no , 'amount' => $order->getNeedPayAmount() , 'client_ip' => \request()->getClientIp() , 'subject' => $order->getSubject() , 'body' => $order->getSubject() , 'extra' => ['openid' => \request('openid')] ]); return $this->success(compact('charge')); ``` 创建 charge 方法定义如下： ``` public function create(array $data, $type = 'default', $app = 'default'); ``` - $data 参数为支付参数，请见 支付参数一节。 - $type 为业务类型，如果只有一种支付业务，不传即可。如果存在多种业务支付类型，比如商城中存在支付订单，余额充值订单。 - $app 具体的应用名称，比如商城APP和活动APP，可能使用不同的支付配置 #### 支付参数 [](#支付参数) 请求参数类型必填描述order\_nostring是商户订单号，适配每个渠道对此参数的要求，必须在商户的系统内唯一。(支付宝全渠道: 1-64 位的数字和字母组合；`wx`: 2-32 位；`wx_pub_scan、cb_wx、cb_wx_pub、cb_wx_pub_qr、cb_wx_pub_scan`:1-32 位的数字和字母组合；`bfb`: 1-20 位；银联全渠道: 8-40 位的数字和字母组合； `yeepay_wap`: 1-50 位；`jdpay_wap`: 1-30 位；`qpay`:1-30 位；`isv_qr、isv_scan、isv_wap`: 8-32 位，不重复，建议时间戳+随机数（或交易顺序号）；`paypal`:1-32 位的数字和字母组合；`ccb_pay、ccb_qr`：1-30 位数字和字母组合；`cmb_wallet`: 6-32 位的数字和字母组合，一天内不能重复，订单日期+订单号唯一定位一笔订单，示例: 20170808test01)。\*\*注：\*\*推荐使用 8-20 位的数字和字母组合，不允许特殊字符。channelstring是已经支持值：amountint是订单总金额，必须大于0，单位为分client\_ipstring是发起支付的客户端IP地址，Laravel 中 `request()->getClientIp()`subjectstring是商品标题，该参数最长为 32 个 Unicode 字符。银联全渠道限制在 32 个字节；支付宝部分渠道不支持特殊字符。bodystring是商品描述信息，该参数最长为 128 个 Unicode 字符。`yeepay_wap` 对于该参数长度限制为 100 个 Unicode 字符；支付宝部分渠道不支持特殊字符。extraarray是在微信公众号支付，小程序支付，需要传递openid。如：`'extra' => ['openid' => \request('openid')]`time\_expiretimestamp否订单失效时间。时间范围在订单创建后的 1 分钟到 15 天，默认为 1 天，创建时间以 Ping++ 服务器时间为准。微信对该参数的时间范围在订单创建后的 1 分钟到 7 天，默认为 2 小时；`upacp、upacp_pc、upacp_wap、cp_b2b、applepay_upacp` 渠道对该参数的有效值限制为 1 小时内；`upacp_b2b` 对该参数的有效值限制为 1 天内；`upacp_qr` 渠道对该参数的有效期默认为 1 天，最大为 30 天。metadataarray否附属参数，会传递给微信和支付宝descriptionstring否订单附件说明#### 返回值 [](#返回值) 发起支付请求后，微信通道会返回 charge 值，如下： ``` { "app": "default", // 应用名称 "type": "default", // 业务类型， "channel": "wx_lite", "order_no": "O2018111919576278725", "amount": 4900, "client_ip": "222.247.67.172", "subject": "【秋款】2018年儿童秋款T 儿童打底衫秋款 竹节棉阔形儿童T恤 等1件商品", "body": "【秋款】2018年儿童秋款T 儿童打底衫秋款 竹节棉阔形儿童T恤 等1件商品", "extra": { "openid": "ozJEr5NrFkYrNGC5rftcOAO4c3OE" }, "charge_id": "ch_QAjx7VNJxp2mstAb8kPc0oZR", "updated_at": "2018-11-20 09:36:45", "created_at": "2018-11-20 09:36:44", "id": 4, "credential": { //客户端支付凭证 "wechat": { "appId": "wx0ae854a59b88cd63", "timeStamp": "1542706604", "nonceStr": "2nbKpiNEY0qHbMaM", "package": "prepay_id=wx201736451424458ba271c9481469876463", "signType": "MD5", "paySign": "8677CEAEDE07E1FCB2E18A460805D98C" } }, "out_trade_no": "wx_w5FZYpe0sEyxuCuXF0p3NP_b" } ``` ### 异步通知 [](#异步通知) 本包会统一处理支付异步通知，可以通过配置文件来修改异步通知的 url。本报收到异步通知后，会执行 `PayNotify::success($charge->type, $charge);` 来通知业务方已经完成支付。 业务方在自己的代码中只需要做以下事情即可： - 实现 `iBrand\Component\Pay\Contracts\PayNotifyContract` 接口，在 `success(Charge $charge)` 方法中完成业务订单的状态变更。 - 在 ServiceProvider 中绑定 `PayNotifyContract` 实现。 `$this->app->bind('ibrand.pay.notify.default',StorePayNotify::class);` 其中 `default` 为业务类型值，需要保持和创建 charge 对象时传递的 `$type` 值一致。 ### 同步查询 [](#同步查询) 通常的业务流程中支付完成后，会跳转到支付成功页面，此时需要去主动同步查询订单状态，防止异步通信异常导致订单状态未正确变更的问题。 ``` $charge = Charge::find(request('charge_id')); $order = PayNotify::success($charge->type, $charge); ``` 配置项 --- [](#配置项) 执行 `php artisan vendor:publish` 后会发布配置文件 `config/ibrand/pay.php` ``` return [ /* * 异步通知路由参数 */ 'route' => [ 'prefix' => 'notify', 'middleware' => ['api'], ], /* * 默认的支付渠道类型，default 默认支付驱动类型基于 yansongda/pay 支付宝实现 */ 'driver' => 'default', 'default' => [ 'alipay' => [ /* * APP_NAME，不同的应用会使用不同的支付参数，举例： * 在 iBrand 有商城订单支付，有活动报名支付，两个小程序是不同的 appid 甚至是不同的支付主体，所以需要配置不同的支付参数 * */ 'default' => [ // 支付宝分配的 APPID 'app_id' => env('ALI_PAYMENT_APP_ID', ''), // 支付宝异步通知地址 'notify_url' => '/notify/alipay', // 支付成功后同步通知地址 'return_url' => '', // 阿里公共密钥，验证签名时使用 'ali_public_key' => env('ALI_PAYMENT_PUBLIC_KEY', ''), // 自己的私钥，签名时使用 'private_key' => env('ALI_PAYMENT_PRIVATE_KEY', ''), // optional，默认 warning；日志路径为：sys_get_temp_dir().'/logs/yansongda.pay.log' 'log' => [ 'file' => storage_path('logs/alipay.log'), // 'level' => 'debug' 'type' => 'single', // optional, 可选 daily. 'max_file' => 30, ], // optional，设置此参数，将进入沙箱模式 // 'mode' => 'dev', ], ], 'wechat' => [ 'default' => [ // 公众号 APPID 'app_id' => env('WECHAT_PAYMENT_APP_ID', ''), // 小程序 APPID 'miniapp_id' => env('WECHAT_PAYMENT_MINIAPP_ID', ''), // APP 引用的 appid 'appid' => env('WECHAT_PAYMENT_APPID', ''), // 微信支付分配的微信商户号 'mch_id' => env('WECHAT_PAYMENT_MCH_ID', ''), // 微信支付异步通知地址 'notify_url' => '/notify/wechat', // 微信支付签名秘钥 'key' => env('WECHAT_PAYMENT_KEY', ''), // 客户端证书路径，退款、红包等需要用到。请填写绝对路径，linux 请确保权限问题。pem 格式。 'cert_client' => '', // 客户端秘钥路径，退款、红包等需要用到。请填写绝对路径，linux 请确保权限问题。pem 格式。 'cert_key' => '', // optional，默认 warning；日志路径为：sys_get_temp_dir().'/logs/yansongda.pay.log' 'log' => [ 'file' => storage_path('logs/wechat.log'), // 'level' => 'debug' 'type' => 'single', // optional, 可选 daily. 'max_file' => 30, ], // optional // 'dev' 时为沙箱模式 // 'hk' 时为东南亚节点 // 'mode' => 'dev', ], // ... ], ], ]; ``` Resources --------- [](#resources) [yansongda/pay](https://github.com/yansongda/pay) 果酱云社区 ----- [](#果酱云社区) [ ![点击跳转](https://camo.githubusercontent.com/6359e5bd680f99c0f946287e22a32d5935d94a942ae2116a0b2f6f0c7a70ccca/68747470733a2f2f63646e2e67756f6a69616e672e636c75622f696d6167652f323032322f30322f31362f77755f316673306a62636f32313832673238306c317661676d376265362e706e67) ](https://guojiang.club/) - 全网真正免费的IT课程平台 - 专注于综合IT技术的在线课程，致力于打造优质、高效的IT在线教育平台 - 课程方向包含Python、Java、前端、大数据、数据分析、人工智能等热门IT课程 - 300+免费课程任你选择 [ ![点击跳转](https://camo.githubusercontent.com/8f168577f9682601d01cf6c726dbbccd911815b2b6d4f999e27475448f22a107/68747470733a2f2f63646e2e67756f6a69616e672e636c75622f696d6167652f323032322f30322f31362f77755f316673306c383261653170713131653433316a366e31376a7331767137362e706e67) ](https://guojiang.club/) ### Health Score 32 — LowBetter than 72% of packages Maintenance18 Infrequent updates — may be unmaintained Popularity31 Limited adoption so far Community14 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 70.4% 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 Every ~82 days Total 9 Last Release 2076d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/05a4dd937f49471fe1d2cb4da6445668df23b2ad2422789b3aaed3ef9459c377?d=identicon)[shjchen](/maintainers/shjchen) --- Top Contributors [![chenbidepro](https://avatars.githubusercontent.com/u/9166101?v=4)](https://github.com/chenbidepro "chenbidepro (19 commits)")[![tangqi1916](https://avatars.githubusercontent.com/u/193469035?v=4)](https://github.com/tangqi1916 "tangqi1916 (8 commits)") --- Tags componentpayibrand ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/ibrand-pay/health.svg) ``` [![Health](https://phpackages.com/badges/ibrand-pay/health.svg)](https://phpackages.com/packages/ibrand-pay) ``` ### Alternatives [yansongda/laravel-pay 专注 Alipay/WeChat/Unipay 的 laravel 支付扩展包 1.1k353.2k9](/packages/yansongda-laravel-pay)[yansongda/hyperf-pay 可能是基于 hyperf 的最优雅的支付宝、微信、银联支付 SDK 了 8959.8k1](/packages/yansongda-hyperf-pay)[guanguans/yii-pay 适配于 Yii 的 alipay 和 wechat 的支付扩展包 515.5k](/packages/guanguans-yii-pay) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)