zoujingli/pay-php-sdk

WxPay and AliPay development of SDK

pay-php-sdk

PHP支付SDK（微信支付 + 支付宝支付）, _(*1)

, _(*2)

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

WeChatDeveloer 代码地址

• Gitee仓库：https://gitee.com/zoujingli/WeChatDeveloper

* Github仓库：https://github.com/zoujingli/WeChatDeveloper

欢迎Star，欢迎Fork！, _(*3)

项目设计及部分源码参考于 yansongda/pay，在此特别感谢！, _(*4)

特点

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

声明

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

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

, _(*5)

环境

• 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()。, _(*6)

两个方法的作用如下：, _(*7)

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

具体实现可以查看源代码。, _(*9)

1、支付宝

SDK 中对应的 driver 和 gateway 如下表所示：, _(*10)

2、微信

SDK 中对应的 driver 和 gateway 如下表所示：, _(*11)

操作

所有网关均支持以下方法, _(*12)

• apply(array $options)
  说明：支付发起接口
  参数：数组类型，订单业务配置项，包含 订单号，订单金额等
  返回：mixed, _(*13)

• refund(array|string $options, $refund_amount = null)
  说明：发起退款接口
  参数：$options 为字符串类型仅对支付宝支付有效，此时代表订单号，第二个参数为退款金额。
  返回：mixed 退款成功，返回 服务器返回的数组；否则返回 false；, _(*14)

• close(array|string $options)
  说明：关闭订单接口
  参数：$options 为字符串类型时代表订单号，如果为数组，则为关闭订单业务配置项，配置项内容请参考各个支付网关官方文档。
  返回：mixed 关闭订单成功，返回 服务器返回的数组；否则返回 false；, _(*15)

• find(string $out_trade_no)
  说明：查找订单接口
  参数：$out_trade_no 为订单号。
  返回：mixed 查找订单成功，返回 服务器返回的数组；否则返回 false；, _(*16)

• verify($data, $sign = null)
  说明：验证服务器返回消息是否合法
  参数：$data 为服务器接收到的原始内容，$sign 为签名信息，当其为空时，系统将自动转化 $data 为数组，然后取 $data['sign']。
  返回：mixed 验证成功，返回 服务器返回的数组；否则返回 false；, _(*17)

实例

// 实例支付对象
$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 '<xml><return_code>SUCCESS</return_code><return_msg>OK</return_msg></xml>';

安装

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

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