PHPackages                             natural-gao/php-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. natural-gao/php-pay

ActiveLibrary

natural-gao/php-pay
===================

PHP 支付扩展

0.0.1(4y ago)04MITPHP

Since May 3Pushed 4y ago1 watchersCompare

[ Source](https://github.com/NaturalGao/php-pay)[ Packagist](https://packagist.org/packages/natural-gao/php-pay)[ RSS](/packages/natural-gao-php-pay/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

[![Packagist](https://camo.githubusercontent.com/a4ab1e8657ce7ff9ca015240fa0ecf4ab50766b5227c6ec504b6885e3d745f3e/68747470733a2f2f706f7365722e707567782e6f72672f616c6970617973646b2f6561737973646b2f762f737461626c65)](https://packagist.org/packages/natural-gao/php-pay)

PHP-PAY
=======

[](#php-pay)

---

项目简介
----

[](#项目简介)

一个借助第三方包整合的支付工具，目前整合了 微信支付、支付宝支付、优云宝。

项目由来
----

[](#项目由来)

工作业务中有这方面需求，目前是借助第三方包整合的，会有点臃肿，有时间会花时间重构，让项目专注于支付，更轻量。

项目进度
----

[](#项目进度)

因业务中要求的功能不多，目前只整合了微信 Native 支付、支付宝扫码支付、优云宝，后面会慢慢完善更多功能。

安装
--

[](#安装)

```
composer require natural-gao/php-pay

```

快速使用
----

[](#快速使用)

创建一个支付宝扫码支付为例：

```
use NaturalGao\PhpPay\Factory;
// 初始化配置
第一个参数是 引擎名称（根据服务文件前缀，例如 AliPayService.php 就是 ali, YouYunPayService.php 就是 you_yun ）；
第二个参数是 配置
Factory::init('ali', $config);

// 创建下单
$response = Factory::service()->createQrCodeOrder($order);
```

返回数据格式:

```
{
    "type": "alipay",
    "data": "http://chart.apis.google.com/chart?chs=200x200&cht=qr&chld=L|0&chl=https%3A%2F%2Fqr.alipay.com%2Fbax08192saiuyc9fpxo0000b"
}
```

**type 是使用的支付类型, data 是返回的数据，可以是任意类型数据，实际根据支付官网为准。**

配置
--

[](#配置)

支付宝

```
    $config = [
        'protocol' => 'https',
        // 网关
        'gatewayHost' => 'openapi.alipay.com',
        // 签名模式
        'signType' => 'RSA2',
        // APPID
        'appId' => '',
        // 私钥
        'merchantPrivateKey' => '',
        // 支付宝公钥证书文件路径 （证书模式必填）
        'alipayCertPath' => '',
        // 支付宝根证书文件路径（证书模式必填）
        'alipayRootCertPath' => '',
        // 应用公钥证书文件路径（证书模式必填）
        'merchantCertPath' => '',
        // 如果采用非证书模式，则无需赋值上面的三个证书路径，改为赋值如下的支付宝公钥字符串即可
        'alipayPublicKey' => '',
        //可设置异步通知接收服务地址（可选）
        'notifyUrl' => '',
        // 可设置AES密钥，调用AES加解密相关接口时需要（可选）
        'encryptKey' => ''
    ];
```

微信

```
$config = [
    'mch_id' => 1360649000,

    // 商户证书
    'private_key' => '',
    'certificate' => '',

     // v3 API 秘钥
    'secret_key' => '',

    // v2 API 秘钥
    'v2_secret_key' => '',

    // 平台证书：微信支付 APIv3 平台证书，需要使用工具下载
    // 下载工具：https://github.com/wechatpay-apiv3/CertificateDownloader
    'platform_certs' => [
        // '/path/to/wechatpay/cert.pem',
    ],

    /**
     * 接口请求相关配置，超时时间等，具体可用参数请参考：
     * https://github.com/symfony/symfony/blob/5.3/src/Symfony/Contracts/HttpClient/HttpClientInterface.php
     */
    'http' => [
        'throw'  => true, // 状态码非 200、300 时是否抛出异常，默认为开启
        'timeout' => 5.0,
        // 'base_uri' => 'https://api.mch.weixin.qq.com/', // 如果你在国外想要覆盖默认的 url 的时候才使用，根据不同的模块配置不同的 uri
    ],
];
```

优云宝

```
$congig = [
   //收款APPID号
   "appid"=>"22222",

   //对应的APPKEY密匙
   "appkey"=>"22222",

   //网关连接地址 一般不做修改
   "server"=>"http://yunpay.youyunnet.com/",   //注意：最后要加斜杠 /

   //支付成功后的跳转地址
   "reurl"=>"http://".$_SERVER['HTTP_HOST']."/",
   //默认当前域名,可根据自己的需求自己开发
   //如果跳转需要带参数 请在AJAX页面自行组合并添加，这个只是一个返回效果并无数据返回
   //请用户不要误认为是异步数据通知的链接

   //获取客户IP(必须)
   "uip"=>getIp(),

   //模板提示支付帮助 1提示 0不提示
   "helpts"=>1 ,

   "alipayh5"=>0 // 0 1是否开启自动生成二维码，开启后云端上传的二维码将失效

];
```

接口
--

[](#接口)

名称描述支持情况createOrder创建订单支付宝createQrCodeOrder创建二维码订单支付宝、微信、优云宝refundOrder订单退款支付宝、微信queryOrder查询订单支付宝、微信（商户订单）、优云宝queryWechatOrder查询微信订单微信（微信订单）queryRefundOrder查询退款订单支付宝、微信closeOrder关闭订单支付宝、微信cancelOrder撤销订单支付宝使用到的包
-----

[](#使用到的包)

- [easywechat ](https://github.com/w7corp/easywechat)

- [alipay-easysdk](https://github.com/alipay/alipay-easysdk)

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 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

1475d ago

### Community

Maintainers

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

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/natural-gao-php-pay/health.svg)

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

###  Alternatives

[overtrue/laravel-wechat

微信 SDK for Laravel

3.0k1.8M53](/packages/overtrue-laravel-wechat)

PHPackages © 2026

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