PHPackages                             hongxuan/smartpay - 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. hongxuan/smartpay

ActiveLibrary[Payment Processing](/categories/payments)

hongxuan/smartpay
=================

an integrated third-party payment tools package

v1.0.0(8y ago)3231MITPHPPHP &gt;=5.6.0

Since Apr 18Pushed 8y ago1 watchersCompare

[ Source](https://github.com/CaiHongxuan/smartpay)[ Packagist](https://packagist.org/packages/hongxuan/smartpay)[ RSS](/packages/hongxuan-smartpay/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

smartpay
========

[](#smartpay)

用于Laravel的第三方支付工具包，使用IOC容器技术，支持composer加载。整合支付宝、微信等支付方式

要求
==

[](#要求)

1. php &gt;= 5.6
2. laravel &gt;= 5.2 （illuminate/support &gt;= 5.2.0， guzzlehttp/guzzle &gt;= 6.0）

安装
==

[](#安装)

1. 安装本扩展包

    ```
    composer require hongxuan/smartpay

    ```
2. 安装配置文件`payment.php`到config目录下

    ```
    php artisan vendor:publish --provider="Hongxuan\Smartpay\PaymentServiceProvider"

    ```
3. 将 PaymentServiceProvider 添加到你的配置文件 config/app.php 的 providers 数组中

    ```
    Hongxuan\Smartpay\PaymentServiceProvider::class,

    ```
4. 也可同时给其起个`Payment`别名，在配置文件 config/app.php 的 aliases 数组中添加：

    ```
    'Payment' => Hongxuan\Smartpay\Facades\Payment::class

    ```

目前实现的功能
=======

[](#目前实现的功能)

1. 支付宝网页扫码支付
2. 支付宝移动端支付
3. 支付宝交易查询
4. 支付宝交易退款
5. 支付宝交易退款查询
6. 支付宝交易关闭
7. 支付宝对账单下载
8. 微信扫码支付
9. 微信公众号支付
10. 微信交易查询
11. 微信交易退款
12. 微信交易退款查询
13. 微信交易关闭
14. 微信对账单下载

使用例子
====

[](#使用例子)

1. 支付：

    ```
        // 支付宝支付
        $result = Payment::driver('alipay')
            ->setPayType('ali_web') // 可不设置此参数，默认为“ali_web”（网页扫码）支付方式，“ali_wap”为移动端支付
            ->setOrder([
                'body'         => '商品描述',
                'subject'      => '订单名称',
                'total_amount' => 0.01,   // 支付金额
                'out_trade_no' => '1010', // 商户订单号
            ])
            ->setNotifyUrl('http://www.baidu.com') // 异步通知地址，公网可以访问，可不设置此参数，默认采用配置文件的"notify_url"参数
            ->setReturnUrl('http://www.baidu.com') // 同步跳转地址，公网可访问，可不设置此参数，默认采用配置文件的"return_url"参数
            ->pay();

        // 微信扫码支付（用户打开扫一扫，扫码商户二维码完成支付）
        $result = Payment::driver('weixin')
            ->setPayType('wx_qr')// 可不设置此参数，默认为“wx_qr”（扫码）支付方式
            ->setOrder([
                'body'         => '商品描述',
                'detail'       => '商品详情', // 商品详情，非必填
                'total_amount' => 0.01,   // 支付金额
                'out_trade_no' => '0101', // 商户订单号
                'product_id'   => '0101', // 商品ID
                'attach'       => 'test', // 附加数据，非必填，在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据的值
                'time_start'   => date('YmdHis'), // 订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010
                'goods_tag'    => 'test', // 商品标记，非必填，代金券或立减优惠功能的参数，说明详见代金券或立减优惠
            ])
            ->setNotifyUrl('http://www.baidu.com') // 异步通知地址，公网可以访问
            ->pay();

        // 微信公众号支付（用户在微信内进入商家的H5页面，页面内调用JSSDK完成支付）
        $result = Payment::driver('weixin')
            ->setPayType('wx_pub')// 可不设置此参数，默认为“wx_qr”（扫码）支付方式
            ->setOrder([
                'body'         => '商品描述',
                'detail'       => '商品详情', // 商品详情，非必填
                'total_amount' => 0.01,   // 支付金额
                'out_trade_no' => '0102', // 商户订单号
                'product_id'   => '0102', // 商品ID
                'attach'       => 'test', // 附加数据，非必填，在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据的值
                'time_start'   => date('YmdHis'), // 订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010
                'goods_tag'    => 'test', // 商品标记，非必填，代金券或立减优惠功能的参数，说明详见代金券或立减优惠
                'openid'       => 'odWrUwmRxJpPsnGpKP4CXKkvPLQ0', // '用户在商户appid下的唯一标识,公众号支付,必须设置该参数
            ])
            ->setNotifyUrl('http://www.baidu.com')// 异步通知地址，公网可以访问
            ->pay();
    ```
2. 交易查询：

    ```
        // 支付宝交易查询
        $result = Payment::driver('alipay')
            ->setOrder([
                'trade_no'     => '',     // 支付宝交易号
                'out_trade_no' => '0101', // 商户订单号
            ])
            ->tradeQuery();

        // 微信交易查询
        $result = Payment::driver('weixin')
            ->setOrder([
                'trade_no'     => '',     // 微信交易号
                'out_trade_no' => '0101', // 商户订单号
            ])
            ->tradeQuery();
    ```
3. 退款：

    ```
        // 支付宝交易退款
        $result = Payment::driver('alipay')
            ->setOrder([
                'refund_amount'  => 0.02,       // 退款金额
                'trade_no'       => '',         // 支付宝交易号
                'out_trade_no'   => '0101',     // 商户订单号
                'out_request_no' => '0101',     // 标识一次退款请求，同一笔交易多次退款需要保证唯一，如需部分退款，则此参数必传
                'refund_reason'  => '退款理由', // 退款原因
            ])
            ->refund();

        // 微信交易退款
        $result = Payment::driver('weixin')
            ->setOrder([
                'total_amount'   => 0.02,   // 订单总金额
                'refund_amount'  => 0.02,   // 退款金额
                'trade_no'       => '',     // 微信交易号
                'out_trade_no'   => '0101', // 商户订单号
                'out_request_no' => '0101', // 设置商户系统内部的退款单号，商户系统内部唯一，同一退款单号多次请求只退一笔
                'refund_reason'  => '退款理由', // 退款原因，非必填
            ])
            ->refund();
    ```
4. 退款查询：

    ```
        // 支付宝交易退款查询
        $result = Payment::driver('alipay')
            ->setOrder([
                'trade_no'       => '',     // 支付宝交易号，优先级：trade_no > out_trade_no
                'out_trade_no'   => '0101', // 商户订单号
                'out_request_no' => '0101', // 请求退款接口时，传入的退款请求号，如果在退款请求时未传入，则该值为创建交易时的外部交易号，必填
            ])
            ->refundQuery();

        // 微信交易退款查询
        $result = Payment::driver('weixin')
            ->setOrder([
                'trade_no'       => '',     // 微信交易号，二选一，优先级：trade_no > out_trade_no
                'out_trade_no'   => '0101', // 商户订单号
            ])
            ->refundQuery();
    ```
5. 关闭交易：

    ```
        // 支付宝交易关闭
        $result = Payment::driver('alipay')
            ->setOrder([
                // trade_no，out_trade_no不可同时为空，优先采用trade_no
                'trade_no'     => '',     // 支付宝交易号
                'out_trade_no' => '0101', // 商户订单号
            ])
            ->close();

        // 微信交易关闭
        $result = Payment::driver('weixin')
            ->setOrder([
                // trade_no，out_trade_no不可同时为空，优先采用trade_no
                'trade_no'     => '',     // 微信交易号
                'out_trade_no' => '0101', // 商户订单号
            ])
            ->close();
    ```
6. 对账单下载：

    ```
        // 支付宝对账单下载
        $result = Payment::driver('alipay')
            ->setOrder([
                // 账单类型，商户通过接口或商户经开放平台授权后其所属服务商通过接口可以获取以下账单类型：trade、signcustomer；
                // trade指商户基于支付宝交易收单的业务账单；signcustomer是指基于商户支付宝余额收入及支出等资金变动的帐务账单；
                'bill_type' => 'signcustomer',
                // 账单时间：日账单格式为yyyy-MM-dd，月账单格式为yyyy-MM。
                'bill_date' => date('Y-m', strtotime('2017-09-16 10:10:10'))
            ])
            ->download();

        // 微信对账单下载
        $result = Payment::driver('weixin')
            ->setOrder([
                // 设置ALL，返回当日所有订单信息；默认值SUCCESS，返回当日成功支付的订单；REFUND，返回当日退款订单；REVOKED，已撤销的订单
                'bill_type' => 'ALL',
                // 设置下载对账单的日期，格式：yyyyMMdd，如：20140603
                'bill_date' => date('Ymd', strtotime('2017-11-16 10:10:10'))
            ])
            ->download();
    ```

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

2944d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/88c96d61f9cda1ae21aba04987ab7299781ac407447aba8717408c1471027356?d=identicon)[宏玄](/maintainers/%E5%AE%8F%E7%8E%84)

---

Top Contributors

[![CaiHongxuan](https://avatars.githubusercontent.com/u/8428950?v=4)](https://github.com/CaiHongxuan "CaiHongxuan (16 commits)")

### Embed Badge

![Health badge](/badges/hongxuan-smartpay/health.svg)

```
[![Health](https://phpackages.com/badges/hongxuan-smartpay/health.svg)](https://phpackages.com/packages/hongxuan-smartpay)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
