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

Abandoned → [zoujingli/wechat-developer](/?search=zoujingli%2Fwechat-developer)Library

zoujingli/pay-php-sdk
=====================

WxPay and AliPay development of SDK

v2.0.0(6y ago)114.0k7[1 issues](https://github.com/zoujingli/pay-php-sdk/issues)1MITPHPPHP &gt;=5.3.3

Since Aug 17Pushed 6y ago2 watchersCompare

[ Source](https://github.com/zoujingli/pay-php-sdk)[ Packagist](https://packagist.org/packages/zoujingli/pay-php-sdk)[ Docs](https://github.com/zoujingli/pay-php-sdk)[ RSS](/packages/zoujingli-pay-php-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (1)

pay-php-sdk
===========

[](#pay-php-sdk)

PHP支付SDK（微信支付 + 支付宝支付）

[![Latest Stable Version](https://camo.githubusercontent.com/80589b1a1106965b7388e7c841c574d07b1389198fe5b084efe93a49c27563e5/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7061792d7068702d73646b2f762f737461626c65)](https://packagist.org/packages/zoujingli/pay-php-sdk)[![Total Downloads](https://camo.githubusercontent.com/e7131e2c0a8fd84b0966d42caac162ee3535e6436e5b4223baf434739797c15c/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7061792d7068702d73646b2f646f776e6c6f616473)](https://packagist.org/packages/zoujingli/pay-php-sdk)[![Latest Unstable Version](https://camo.githubusercontent.com/e5dd9cef5d84730f4b776c519fc5a81f23fe73888781675fd0948563b607c586/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7061792d7068702d73646b2f762f756e737461626c65)](https://packagist.org/packages/zoujingli/pay-php-sdk)[![License](https://camo.githubusercontent.com/16423e06ef9f59a19ca9ae85779d22971e8b2d71d3d961e27b8587138ecbe868/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7061792d7068702d73646b2f6c6963656e7365)](https://packagist.org/packages/zoujingli/pay-php-sdk)

感谢大家对此项目的支持，目前 WeChatDeveloer 已经完全可以替代它，此项目已经停止更新。有需要做 微信支付、支付宝支付、微信服务号管理、微信小程序管理、微信开放平台 开发的朋友可以转移到 [WeChatDeveloer](https://github.com/zoujingli/WeChatDeveloper) ，谢谢。
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#感谢大家对此项目的支持目前-wechatdeveloer-已经完全可以替代它此项目已经停止更新有需要做-微信支付支付宝支付微信服务号管理微信小程序管理微信开放平台-开发的朋友可以转移到-wechatdeveloer-谢谢)

WeChatDeveloer 代码地址
-------------------

[](#wechatdeveloer-代码地址)

- Gitee仓库：
- Github仓库：

---

欢迎`Star`，欢迎`Fork`！

项目设计及部分源码参考于 [yansongda/pay](https://github.com/yansongda/pay)，在此特别感谢！

特点
--

[](#特点)

- 代码简洁，无需加载多余组件，可应用于任何平台或框架
- 隐藏开发者不需要关注的细节，完全内部实现
- 根据支付宝、微信最新`API`开发集成
- 高度抽象的类，免去各种拼`json`与`xml`的痛苦
- 符合`PSR`标准，你可以各种方便的与你的框架集成
- 文件结构清晰易理解，可以随心所欲添加本项目中没有的支付网关
- 方法使用更优雅，不必再去研究那些奇怪的的方法名或者类名是做啥用的

声明
--

[](#声明)

- 代码与框架部分参考于互联网开源项目
- `SDK`全部源码基于`MIT`协议开源，完全免费
- **开发交流`QQ`群：513350915**

若对您有帮助，可以**赞助**支持下作者哦！
----------------------

[](#若对您有帮助可以赞助支持下作者哦)

[![](https://camo.githubusercontent.com/24bcc2489b35b56d225234874cfc2ead9fa0a3b8ca6ccf32dfbf5d1d7a583420/687474703a2f2f706c7567732e63746f6c6f672e636f6d2f7061792e706e67)](https://camo.githubusercontent.com/24bcc2489b35b56d225234874cfc2ead9fa0a3b8ca6ccf32dfbf5d1d7a583420/687474703a2f2f706c7567732e63746f6c6f672e636f6d2f7061792e706e67)

环境
--

[](#环境)

- PHP 5.3+
- composer

配置
--

[](#配置)

```
$config = [
    // 微信支付参数
    'wechat' => [
        'debug'      => false, // 沙箱模式
        'app_id'     => '', // 应用ID
        'mch_id'     => '', // 微信支付商户号
        'mch_key'    => '', // 微信支付密钥
        'ssl_cer'    => '', // 微信证书 cert 文件
        'ssl_key'    => '', // 微信证书 key 文件
        'notify_url' => '', // 支付通知URL
        'cache_path' => '',// 缓存目录配置（沙箱模式需要用到）
    ],
    // 支付宝支付参数
    'alipay' => [
        'debug'       => false, // 沙箱模式
        'app_id'      => '', // 应用ID
        'public_key'  => '', // 支付宝公钥(1行填写)
        'private_key' => '', // 支付宝私钥(1行填写)
        'notify_url'  => '', // 支付通知URL
    ]
];
```

架构
--

[](#架构)

由于各支付网关参差不齐，所以我们抽象了两个方法 `driver()`，`gateway()`。

两个方法的作用如下：

`driver()` ： 确定支付平台，如 `alipay`,`wechat`;
`gateway()`： 确定支付网关，如 `app`,`pos`,`scan`,`transfer`,`wap`,`...`

具体实现可以查看源代码。

### 1、支付宝

[](#1支付宝)

SDK 中对应的 driver 和 gateway 如下表所示：

drivergateway描述alipayweb电脑支付alipaywap手机网站支付alipayappAPP 支付alipaypos刷卡支付alipayscan扫码支付alipaybill电子账单alipaytransfer 帐户转账（可用于平台用户提现）### 2、微信

[](#2微信)

SDK 中对应的 driver 和 gateway 如下表所示：

drivergateway描述wechatmp公众号支付wechatminiapp小程序支付wechatwapH5 支付（不支持沙箱模式）wechatscan扫码支付wechatpos刷卡支付wechatappAPP 支付wechatbill电子账单wechattransfer企业付款到零钱（可用于平台用户提现）wechatbank企业付款到银行卡（可用于平台用户提现）操作
--

[](#操作)

所有网关均支持以下方法

- apply(array $options)
    说明：支付发起接口
    参数：数组类型，订单业务配置项，包含 订单号，订单金额等
    返回：mixed
- refund(array|string $options, $refund\_amount = null)
    说明：发起退款接口
    参数：`$options` 为字符串类型仅对`支付宝支付`有效，此时代表订单号，第二个参数为退款金额。
    返回：mixed 退款成功，返回 服务器返回的数组；否则返回 false；
- close(array|string $options)
    说明：关闭订单接口
    参数：`$options` 为字符串类型时代表订单号，如果为数组，则为关闭订单业务配置项，配置项内容请参考各个支付网关官方文档。
    返回：mixed 关闭订单成功，返回 服务器返回的数组；否则返回 false；
- find(string $out\_trade\_no)
    说明：查找订单接口
    参数：`$out_trade_no` 为订单号。
    返回：mixed 查找订单成功，返回 服务器返回的数组；否则返回 false；
- verify($data, $sign = null)
    说明：验证服务器返回消息是否合法
    参数：`$data` 为服务器接收到的原始内容，`$sign` 为签名信息，当其为空时，系统将自动转化 `$data` 为数组，然后取 `$data['sign']`。
    返回：mixed 验证成功，返回 服务器返回的数组；否则返回 false；

实例
--

[](#实例)

```
// 实例支付对象
$pay = new \Pay\Pay($config);

try {
    $options = $pay->driver('alipay')->gateway('app')->apply($payOrder);
    var_dump($options);
} catch (Exception $e) {
    echo "创建订单失败，" . $e->getMessage();
}
```

通知
--

[](#通知)

#### 支付宝

[](#支付宝)

```
// 实例支付对象
$pay = new \Pay\Pay($config);

if ($pay->driver('alipay')->gateway()->verify($_POST)) {
    file_put_contents('notify.txt', "收到来自支付宝的异步通知\r\n", FILE_APPEND);
    file_put_contents('notify.txt', "订单单号：{$_POST['out_trade_no']}\r\n", FILE_APPEND);
    file_put_contents('notify.txt', "订单金额：{$_POST['total_amount']}\r\n\r\n", FILE_APPEND);
} else {
    file_put_contents('notify.txt', "收到异步通知\r\n", FILE_APPEND);
}
```

#### 微信

[](#微信)

```
$pay = new \Pay\Pay($config);
$verify = $pay->driver('wechat')->gateway('mp')->verify(file_get_contents('php://input'));

if ($verify) {
    file_put_contents('notify.txt', "收到来自微信的异步通知\r\n", FILE_APPEND);
    file_put_contents('notify.txt', "订单单号：{$verify['out_trade_no']}\r\n", FILE_APPEND);
    file_put_contents('notify.txt', "订单金额：{$verify['total_fee']}\r\n\r\n", FILE_APPEND);
} else {
    file_put_contents('notify.txt', "收到异步通知\r\n", FILE_APPEND);
}

echo 'SUCCESSOK';
```

安装
--

[](#安装)

```
// 方法一、 使用composer安装
composer require zoujingli/pay-php-sdk

// 方法二、 直接加载支付SDK
include 'init.php'
```

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity53

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

2457d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c806d477ba01d9441023f3cc9a7c70e6491a189d0aae80bca2cc444691e31723?d=identicon)[zoujingli](/maintainers/zoujingli)

---

Top Contributors

[![zoujingli](https://avatars.githubusercontent.com/u/4349951?v=4)](https://github.com/zoujingli "zoujingli (1 commits)")

---

Tags

alipayWxpaypay-php-sdk

### Embed Badge

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

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

###  Alternatives

[yansongda/pay

可能是我用过的最优雅的 Alipay 和 WeChat 的支付 SDK 扩展包了

5.3k1.2M53](/packages/yansongda-pay)[chen-see/chen-pay

免签约支付宝与微信双支付，根据COOKIE

44987.1k](/packages/chen-see-chen-pay)[yansongda/laravel-pay

专注 Alipay/WeChat/Unipay 的 laravel 支付扩展包

1.1k353.2k9](/packages/yansongda-laravel-pay)[zoujingli/wechat-developer

WeChat and Alipay Platform Development

1.6k136.9k14](/packages/zoujingli-wechat-developer)[lokielse/omnipay-alipay

Alipay gateway for Omnipay payment processing library

587421.0k11](/packages/lokielse-omnipay-alipay)[latrell/alipay

支付宝SDK在Laravel5封装包。

40349.2k](/packages/latrell-alipay)

PHPackages © 2026

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