PHPackages                             guanhui07/pay-sdk - 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. guanhui07/pay-sdk

ActiveLibrary[Payment Processing](/categories/payments)

guanhui07/pay-sdk
=================

PHP 集成支付 SDK ，集成了支付宝、微信支付的支付接口和其它相关接口的操作。

v3.1.7(1y ago)014MITPHPPHP >=5.5

Since Oct 12Pushed 1y agoCompare

[ Source](https://github.com/guanhui07/PaySDK)[ Packagist](https://packagist.org/packages/guanhui07/pay-sdk)[ RSS](/packages/guanhui07-pay-sdk/feed)WikiDiscussions dev Synced 1mo ago

READMEChangelogDependencies (2)Versions (42)Used By (0)

PaySDK
======

[](#paysdk)

[![Latest Version](https://camo.githubusercontent.com/3a077796ca852487c1aedce1df44f8fb73d08300236fe5398492b71bce8b2bc5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f797572756e736f66742f7061792d73646b2e737667)](https://packagist.org/packages/yurunsoft/pay-sdk)[![Php Version](https://camo.githubusercontent.com/913f261430ae17dc0b7a17c7877fdf3090f36705b5ad84b40801cd47ee732ba9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d2533453d352e352d627269676874677265656e2e737667)](https://secure.php.net/)[![IMI Doc](https://camo.githubusercontent.com/8a45ed26be92338e9c97fc73a6d772a77ee94fb973e93efc89decb1ea59a8bd7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d70617373696e672d677265656e2e737667)](http://doc.yurunsoft.com/PaySDK)[![IMI License](https://camo.githubusercontent.com/93bcacfd9ad0141e803fe4becb3f2a427a464832396e32ba8081090e56bda3ad/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f597572756e736f66742f50617953444b2e737667)](https://github.com/Yurunsoft/PaySDK/blob/master/LICENSE)

介绍
--

[](#介绍)

PaySDK 是 PHP 集成支付 SDK ，集成了支付宝、微信支付的支付接口和其它相关接口的操作。

无框架依赖，支持所有框架，支持 Swoole 协程环境。

我们有完善的在线技术文档：

API 文档：

此项目进入维护阶段，不会支持微信V3接口，懒得跟着他们折腾，如有需要请找别处！

作者本人不提供任何技术支持，如有需要可以加群讨论：17916227 [![点击加群](https://camo.githubusercontent.com/75b53e353bb9e5064662e185a6d39f4bb88c4e45bd3a1240ddf599525edb6afa/68747470733a2f2f7075622e69647171696d672e636f6d2f7770612f696d616765732f67726f75702e706e67 "点击加群")](https://jq.qq.com/?_wv=1027&k=5wXf4Zq)，有没有人回复就不一定了。

大家在开发中肯定会对接各种各样的支付平台，我个人精力有限，欢迎各位来 [Github](https://github.com/Yurunsoft/PaySDK) 提交 PR，一起完善 PaySDK ，让它能够支持更多的支付平台，更加稳定可靠好用。

支持的支付接口
-------

[](#支持的支付接口)

### 支付宝

[](#支付宝)

- 即时到账-电脑网站支付（老）
- 即时到账-手机网站支付（老）
- 当面付
- 手机网站支付
- 电脑网站支付
- APP支付服务端
- 小程序支付
- 单笔转账到支付宝账户
- 海外支付（电脑网站、手机网站、APP、扫码）
- 海关报关
- 其它辅助交易接口（退款、查询等）

### 微信支付

[](#微信支付)

- 刷卡支付
- 公众号支付
- 扫码支付
- APP支付
- H5支付
- 小程序支付
- 企业付款到零钱
- 企业付款到银行卡
- 海外支付（刷卡、公众号、扫码、APP）
- 海关报关
- 其它辅助交易接口（退款、查询等）

安装
--

[](#安装)

在您的composer.json中加入配置：

`PHP >= 5.5`

```
{
    "require": {
        "yurunsoft/pay-sdk": "~3.0"
    }
}
```

`PHP >= 5.4`

```
{
    "require": {
        "yurunsoft/pay-sdk": "~2.0"
    }
}
```

> 3.x 版本支持 PHP >= 5.5，持续迭代维护中

> 2.x 版本支持 PHP >= 5.4，支持长期 BUG 维护，保证稳定可用，停止功能性更新

然后执行`composer update`命令。

代码示例
----

[](#代码示例)

### 支付宝即时到账

[](#支付宝即时到账)

```
// SDK实例化，传入公共配置
$pay = new \Yurun\PaySDK\Alipay\SDK($params);

// 支付接口
$request = new \Yurun\PaySDK\Alipay\Params\Pay\Request;
$request->notify_url = ''; // 支付后通知地址（作为支付成功回调，这个可靠）
$request->return_url = ''; // 支付后跳转返回地址
$request->businessParams->seller_id = $GLOBALS['PAY_CONFIG']['appid']; // 卖家支付宝用户号
$request->businessParams->out_trade_no = 'test' . mt_rand(10000000,99999999); // 商户订单号
$request->businessParams->total_fee = 0.01; // 价格
$request->businessParams->subject = '测试商品'; // 商品标题

// 跳转到支付页面
// $pay->redirectExecute($request);

// 获取跳转url
$pay->prepareExecute($request, $url);
var_dump($url);
```

### 支付宝手机网站支付

[](#支付宝手机网站支付)

```
// SDK实例化，传入公共配置
$pay = new \Yurun\PaySDK\AlipayApp\SDK($params);

// 支付接口
$request = new \Yurun\PaySDK\AlipayApp\Wap\Params\Pay\Request;
$request->notify_url = ''; // 支付后通知地址（作为支付成功回调，这个可靠）
$request->return_url = ''; // 支付后跳转返回地址
$request->businessParams->out_trade_no = 'test' . mt_rand(10000000,99999999); // 商户订单号
$request->businessParams->total_amount = 0.01; // 价格
$request->businessParams->subject = '小米手机9黑色陶瓷尊享版'; // 商品标题

// 跳转到支付页面
// $pay->redirectExecute($request);

// 获取跳转url
$pay->prepareExecute($request, $url);
var_dump($url);
```

### 微信H5支付

[](#微信h5支付)

```
// SDK实例化，传入公共配置
$pay = new \Yurun\PaySDK\Weixin\SDK($params);

// 支付接口
$request = new \Yurun\PaySDK\Weixin\H5\Params\Pay\Request;
$request->body = 'test'; // 商品描述
$request->out_trade_no = 'test' . mt_rand(10000000,99999999); // 订单号
$request->total_fee = 1; // 订单总金额，单位为：分
$request->spbill_create_ip = '127.0.0.1'; // 客户端ip
$request->notify_url = ''; // 异步通知地址

// 调用接口
$result = $pay->execute($request);
if($pay->checkResult())
{
    // 跳转支付界面
    header('Location: ' . $result['mweb_url']);
}
else
{
    var_dump($pay->getErrorCode() . ':' . $pay->getError());
}
exit;
```

### Swoole 协程环境支持

[](#swoole-协程环境支持)

在支付、退款异步通知中，需要赋值 `Swoole` 的 `Request` 和 `Response` 对象，或者遵循 PSR-7 标准的对象即可。

主流框架的 `Request` 和 `Response` 对象，一般都遵循 PSR-7 标准，可以直接使用。

#### imi 框架中使用

[](#imi-框架中使用)

imi 是基于 PHP Swoole 的高性能协程应用开发框架，它支持 HttpApi、WebSocket、TCP、UDP 服务的开发。

在 Swoole 的加持下，相比 php-fpm 请求响应能力，I/O密集型场景处理能力，有着本质上的提升。

imi 框架拥有丰富的功能组件，可以广泛应用于互联网、移动通信、企业软件、云计算、网络游戏、物联网（IOT）、车联网、智能家居等领域。可以使企业 IT 研发团队的效率大大提升，更加专注于开发创新产品。

```
/**
 * 这是一个在控制器中的动作方法
 * @Action
 */
public function test()
{
    $payNotify = new class extends \Yurun\PaySDK\Weixin\Notify\Pay
    {
        /**
         * 后续执行操作
         * @return void
         */
        protected function __exec()
        {

        }
    };
    $context = RequestContext::getContext();
    // 下面两行很关键
    $payNotify->swooleRequest = $context['request'];
    $payNotify->swooleResponse = $context['response'];

    $sdk->notify($payNotify);

    // 这句话必须填写
    return $payNotify->swooleResponse;
}
```

#### 其它框架（Swoole 对象）

[](#其它框架swoole-对象)

```
$payNotify = new class extends \Yurun\PaySDK\Weixin\Notify\Pay
{
    /**
     * 后续执行操作
     * @return void
     */
    protected function __exec()
    {

    }
};
// 下面两行很关键，$request、$response 从 request 中获取
// 或者查阅如何从你使用的框架中获取
$payNotify->swooleRequest = $request;
$payNotify->swooleResponse = $response;

$sdk->notify($payNotify);
```

#### 其它框架（PSR-7 对象）

[](#其它框架psr-7-对象)

```
$payNotify = new class extends \Yurun\PaySDK\Weixin\Notify\Pay
{
    /**
     * 后续执行操作
     * @return void
     */
    protected function __exec()
    {

    }
};
// 目前主流 Swoole 基本都支持 PSR-7 标准的对象
// 所以可以直接传入，如何获取请查阅对应框架的文档
$payNotify->swooleRequest = $request;
$payNotify->swooleResponse = $response;

$sdk->notify($payNotify);

// 处理完成后需要将 $response 从控制器返回或者赋值给上下文
// 不同框架的操作不同，请自行查阅对应框架的文档
return $payNotify->swooleResponse;
```

商业服务
----

[](#商业服务)

**服务内容：**

- 低费率开户（仅合法商户）
- 问题排查及咨询
- 代接支付
- 其它合作

如有需要加QQ：`369124067` 微信：`wx_zhangrunyu`（注明来意）

捐赠
--

[](#捐赠)

[![](https://raw.githubusercontent.com/Yurunsoft/PaySDK/master/res/pay.png)](https://raw.githubusercontent.com/Yurunsoft/PaySDK/master/res/pay.png)

开源不求盈利，多少都是心意，生活不易，随缘随缘……

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance36

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 93.6% 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 ~64 days

Recently: every ~263 days

Total

40

Last Release

614d ago

Major Versions

v1.0.12 → v2.02018-07-09

v2.x-dev → v3.0.02020-03-24

PHP version history (3 changes)v1.0.4PHP ^5.4|^7.0

v3.0.0PHP >=7.1

v3.0.1PHP >=5.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/3abde3fccf025ce86670101d7cfa0641d2415c9daad93e5f0c9573a2b23ddbda?d=identicon)[guanhui07](/maintainers/guanhui07)

---

Top Contributors

[![Yurunsoft](https://avatars.githubusercontent.com/u/20104656?v=4)](https://github.com/Yurunsoft "Yurunsoft (175 commits)")[![lvjiaben](https://avatars.githubusercontent.com/u/90166263?v=4)](https://github.com/lvjiaben "lvjiaben (4 commits)")[![LRRun](https://avatars.githubusercontent.com/u/37306014?v=4)](https://github.com/LRRun "LRRun (2 commits)")[![l1n6yun](https://avatars.githubusercontent.com/u/19780706?v=4)](https://github.com/l1n6yun "l1n6yun (1 commits)")[![anxiaowen](https://avatars.githubusercontent.com/u/22000601?v=4)](https://github.com/anxiaowen "anxiaowen (1 commits)")[![sy-records](https://avatars.githubusercontent.com/u/33931153?v=4)](https://github.com/sy-records "sy-records (1 commits)")[![lanshe](https://avatars.githubusercontent.com/u/672378?v=4)](https://github.com/lanshe "lanshe (1 commits)")[![BadmintonCode](https://avatars.githubusercontent.com/u/17247494?v=4)](https://github.com/BadmintonCode "BadmintonCode (1 commits)")[![guanhui07](https://avatars.githubusercontent.com/u/5820457?v=4)](https://github.com/guanhui07 "guanhui07 (1 commits)")

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/guanhui07-pay-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/guanhui07-pay-sdk/health.svg)](https://phpackages.com/packages/guanhui07-pay-sdk)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[yurunsoft/pay-sdk

PHP 集成支付 SDK ，集成了支付宝、微信支付的支付接口和其它相关接口的操作。

893100.3k1](/packages/yurunsoft-pay-sdk)[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)

PHPackages © 2026

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