PHPackages                             longcz/awpaysdk - 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. longcz/awpaysdk

ActiveLibrary[Payment Processing](/categories/payments)

longcz/awpaysdk
===============

AliPay and WeChatPay Integrate SDK

1.0.0(6y ago)15MITPHPPHP >=5.3.3

Since Oct 11Pushed 6y ago1 watchersCompare

[ Source](https://github.com/longcz/awpaysdk)[ Packagist](https://packagist.org/packages/longcz/awpaysdk)[ Docs](https://github.com/longcz/awpaysdk)[ RSS](/packages/longcz-awpaysdk/feed)WikiDiscussions master Synced today

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

awpaysdk
========

[](#awpaysdk)

#### 聚合支付SDK（支付宝支付、微信支付）

[](#聚合支付sdk支付宝支付微信支付)

### 描述

[](#描述)

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

安装
--

[](#安装)

```
// 方法一、 使用composer安装
composer require longcz/awpaysdk

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

### 支付配置

[](#支付配置)

```
$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
    ]
];
```

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

[](#sdk-中对应的-driver-和-gateway-如下表所示)

##### 1、支付宝

[](#1支付宝)

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

[](#2微信)

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

[](#架构)

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

### 操作

[](#操作)

所有网关均支持以下方法

- 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';
```

#### 2019年10月11日

[](#2019年10月11日)

- 正式发布（引用zoujingli/pay-php-sdk修改）

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

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

2404d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4b1199aa5c3954987195d9e303101c49fd03ae5ef319559211a8c289cfc619f4?d=identicon)[longcz](/maintainers/longcz)

---

Top Contributors

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

---

Tags

alipayWxpayawpaysdk

### Embed Badge

![Health badge](/badges/longcz-awpaysdk/health.svg)

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

###  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)[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)[yansongda/hyperf-pay

可能是基于 hyperf 的最优雅的支付宝、微信、银联支付 SDK 了

8959.8k1](/packages/yansongda-hyperf-pay)

PHPackages © 2026

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