luoyy/pay-php-sdk

This package is abandoned and no longer maintained. The author suggests using the yansongda/pay package instead.

WxPay and AliPay development of SDK

v1.1.4 2020-06-17 03:24 UTC

Requires

• php: >=5.4
• ext-curl: *
• ext-openssl: *

MIT

• alipay
• Wxpay
• pay-php-sdk

README

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

欢迎Star，欢迎Fork！

项目设计及部分源码参考于 yansongda/pay，在此特别感谢！

特点

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

声明

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

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

环境

• 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
    ],
    'kjalipay' => [
        // APi地址
        'api_url' => '',
        // 应用编号
        'app_no' => '',
        // 商户号
        'merchantid' => '',
        // 商户密钥
        'merchantkey' => '',
        // 支付成功通知地址
        'notify_url' => '',
        // 网页支付回跳地址
        'return_url' => '',
        // 缓存目录配置
        'cache_path' => '',
    ],
    'ruilian' => [
        // 商户号
        'pay_memberid' => '',
        // 商户密钥
        'merchantkey' => '',
        // 支付成功通知地址
        'notify_url' => '',
        // 网页支付回跳地址
        'return_url' => '',
        // 缓存目录配置
        'cache_path' => '',
    ],
    'shoppay' => [
        // 商户号
        'customerid' => '',
        // 商户密钥
        'merchantkey' => '',
        // 支付成功通知地址
        'notify_url' => '',
        // 网页支付回跳地址
        'return_url' => '',
        // 缓存目录配置
        'cache_path' => '',
    ],
];

架构

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

两个方法的作用如下：

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

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

1、支付宝

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

driver	gateway	描述
alipay	web	电脑支付
alipay	wap	手机网站支付
alipay	app	APP 支付
alipay	pos	刷卡支付
alipay	scan	扫码支付
alipay	bill	电子账单
alipay	transfer	帐户转账（可用于平台用户提现）

2、微信

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

driver	gateway	描述
wechat	mp	公众号支付
wechat	miniapp	小程序支付
wechat	wap	H5 支付（不支持沙箱模式）
wechat	scan	扫码支付
wechat	pos	刷卡支付
wechat	app	APP 支付
wechat	bill	电子账单
wechat	transfer	企业付款到零钱（可用于平台用户提现）
wechat	bank	企业付款到银行卡（可用于平台用户提现）

操作

所有网关均支持以下方法

• 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 "success";

安装

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

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