README

聚合支付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如下表所示：

1、支付宝

2、微信

架构

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 '<xml><return_code>SUCCESS</return_code><return_msg>OK</return_msg></xml>';

2019年10月11日

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