zoujingli / pay-php-sdk
WxPay and AliPay development of SDK
Installs: 3 885
Dependents: 1
Suggesters: 0
Security: 0
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: >=5.3.3
- ext-curl: *
- ext-openssl: *
This package is auto-updated.
Last update: 2023-03-20 08:15:57 UTC
README
PHP支付SDK(微信支付 + 支付宝支付)
感谢大家对此项目的支持,目前 WeChatDeveloer 已经完全可以替代它,此项目已经停止更新。有需要做 微信支付、支付宝支付、微信服务号管理、微信小程序管理、微信开放平台 开发的朋友可以转移到 WeChatDeveloer ,谢谢。
WeChatDeveloer 代码地址
- Gitee仓库:https://gitee.com/zoujingli/WeChatDeveloper
- Github仓库:https://github.com/zoujingli/WeChatDeveloper
欢迎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 ] ];
架构
由于各支付网关参差不齐,所以我们抽象了两个方法 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 | 描述 |
---|---|---|
mp | 公众号支付 | |
miniapp | 小程序支付 | |
wap | H5 支付(不支持沙箱模式) | |
scan | 扫码支付 | |
pos | 刷卡支付 | |
app | APP 支付 | |
bill | 电子账单 | |
transfer | 企业付款到零钱(可用于平台用户提现) | |
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 '<xml><return_code>SUCCESS</return_code><return_msg>OK</return_msg></xml>';
安装
// 方法一、 使用composer安装
composer require zoujingli/pay-php-sdk
// 方法二、 直接加载支付SDK
include 'init.php'