Info

Content

可能是你用过的最优雅的支付宝和微信支付 SDK 了 —— Laravel Pay

Created 7 years ago by 学院君, Updated 4 years ago Revision #3 101103 views 28 likes 4 collects

概述

开发了多次支付宝与微信支付后，很自然产生一种反感，惰性又来了，想在网上找相关的轮子，可是一直没有找到一款自己觉得逞心如意的，要么使用起来太难理解，要么文件结构太杂乱，只有自己撸起袖子干了。

Github： https://github.com/yansongda/pay
gitee： https://gitee.com/yansongda/pay
Laravel 扩展包：https://github.com/yansongda/laravel-pay

欢迎 Star，欢迎 PR！

潜水了这么久，自己学习了很多，是时候回馈社区了！

特点

命名不那么乱七八糟
隐藏开发者不需要关注的细节
根据支付宝、微信最新 API 开发而成
高度抽象的类，免去各种拼 JSON 与 XML 的痛苦
符合 PSR 标准，你可以各种方便的与你的框架集成
文件结构清晰易理解，可以随心所欲添加本项目中没有的支付网关
方法使用更优雅，不必再去研究那些奇怪的的方法名或者类名是做啥用的

以上部分引用了 @overtrue 的部分说明，在此感谢！:satisfied:

运行环境

PHP 5.6+
Composer

支持的支付网关

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

driver：确定支付平台，如支付宝、微信;
gateway()：确定支付网关。通过此方法，确定支付平台下的支付网关。例如，支付宝下有「电脑网站支付」，「手机网站支付」，「APP 支付」三种支付网关，分别通过传入 web、wap、app 确定。

详细思路可以查看源代码。

支付宝

电脑支付
手机网站支付
APP 支付

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

driver	gateway	描述
alipay	web	电脑支付
alipay	wap	手机网站支付
alipay	app	APP 支付

微信

公众号支付
小程序支付
H5 支付
扫码支付
刷卡支付

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

driver	gateway	描述
wechat	mp	公众号支付
wechat	miniapp	小程序支付
wechat	wap	H5 支付
wechat	scan	扫码支付
wechat	pos	刷卡支付

支持的方法

所有网关均支持以下方法

pay(array $config_biz)

说明：支付接口

参数：数组类型，订单业务配置项，包含订单号，订单金额等

返回：mixed 详情请看「支付网关配置说明与返回值」一节。

refund(array|string $config_biz, $refund_amount = null)

说明：退款接口

参数：$config_biz 为字符串类型仅对支付宝支付有效，此时代表订单号，第二个参数为退款金额。

返回：mixed 退款成功，返回服务器返回的数组；否则返回 false；

close(array|string $config_biz)

说明：关闭订单接口

参数：$config_biz 为字符串类型时代表订单号，如果为数组，则为关闭订单业务配置项，配置项内容请参考各个支付网关官方文档。

返回：mixed 关闭订单成功，返回服务器返回的数组；否则返回 false；

find(string $out_trade_no)

说明：查找订单接口

参数：$out_trade_no 为订单号。

返回：mixed 查找订单成功，返回服务器返回的数组；否则返回 false；

verify($data, $sign = null)

说明：验证服务器返回消息是否合法

参数：$data 为服务器接收到的原始内容，$sign 为签名信息，当其为空时，系统将自动转化 $data 为数组，然后取 $data['sign']。

返回：mixed 验证成功，返回服务器返回的数组；否则返回 false；

快速上手

通过 Composer 安装：

xxxxxxxxxx
 
composer require yansongda/pay

使用说明：

一个完整的例子

代码片段

xxxxxxxxxx
 
<?php
​
namespace App\Http\Controllers;
​
use Yansongda\Pay\Pay;
use Illuminate\Http\Request;
​
class PayController extends Controller
{
    protected $config = [
        'alipay' => [
            'app_id' => '2016082000295641',
            'notify_url' => 'http://yansongda.cn/alipay_notify.php',
            'return_url' => 'http://yansongda.cn/return.php',
            'ali_public_key' => 'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuWJKrQ6SWvS6niI+4vEVZiYfjkCfLQfoFI2nCp9ZLDS42QtiL4Ccyx8scgc3nhVwmVRte8f57TFvGhvJD0upT4O5O/lRxmTjechXAorirVdAODpOu0mFfQV9y/T9o9hHnU+VmO5spoVb3umqpq6D/Pt8p25Yk852/w01VTIczrXC4QlrbOEe3sr1E9auoC7rgYjjCO6lZUIDjX/oBmNXZxhRDrYx4Yf5X7y8FRBFvygIE2FgxV4Yw+SL3QAa2m5MLcbusJpxOml9YVQfP8iSurx41PvvXUMo49JG3BDVernaCYXQCoUJv9fJwbnfZd7J5YByC+5KM4sblJTq7bXZWQIDAQAB',
            'private_key' => 'MIIEpAIBAAKCAQEAs6+F2leOgOrvj9jTeDhb5q46GewOjqLBlGSs/bVL4Z3fMr3p+Q1Tux/6uogeVi/eHd84xvQdfpZ87A1SfoWnEGH5z15yorccxSOwWUI+q8gz51IWqjgZxhWKe31BxNZ+prnQpyeMBtE25fXp5nQZ/pftgePyUUvUZRcAUisswntobDQKbwx28VCXw5XB2A+lvYEvxmMv/QexYjwKK4M54j435TuC3UctZbnuynSPpOmCu45ZhEYXd4YMsGMdZE5/077ZU1aU7wx/gk07PiHImEOCDkzqsFo0Buc/knGcdOiUDvm2hn2y1XvwjyFOThsqCsQYi4JmwZdRa8kvOf57nwIDAQABAoIBAQCw5QCqln4VTrTvcW+msB1ReX57nJgsNfDLbV2dG8mLYQemBa9833DqDK6iynTLNq69y88ylose33o2TVtEccGp8Dqluv6yUAED14G6LexS43KtrXPgugAtsXE253ZDGUNwUggnN1i0MW2RcMqHdQ9ORDWvJUCeZj/AEafgPN8AyiLrZeL07jJz/uaRfAuNqkImCVIarKUX3HBCjl9TpuoMjcMhz/MsOmQ0agtCatO1eoH1sqv5Odvxb1i59c8Hvq/mGEXyRuoiDo05SE6IyXYXr84/Nf2xvVNHNQA6kTckj8shSi+HGM4mO1Y4Pbb7XcnxNkT0Inn6oJMSiy56P+CpAoGBAO1O+5FE1ZuVGuLb48cY+0lHCD+nhSBd66B5FrxgPYCkFOQWR7pWyfNDBlmO3SSooQ8TQXA25blrkDxzOAEGX57EPiipXr/hy5e+WNoukpy09rsO1TMsvC+v0FXLvZ+TIAkqfnYBgaT56ku7yZ8aFGMwdCPL7WJYAwUIcZX8wZ3dAoGBAMHWplAqhe4bfkGOEEpfs6VvEQxCqYMYVyR65K0rI1LiDZn6Ij8fdVtwMjGKFSZZTspmsqnbbuCE/VTyDzF4NpAxdm3cBtZACv1Lpu2Om+aTzhK2PI6WTDVTKAJBYegXaahBCqVbSxieR62IWtmOMjggTtAKWZ1P5LQcRwdkaB2rAoGAWnAPT318Kp7YcDx8whOzMGnxqtCc24jvk2iSUZgb2Dqv+3zCOTF6JUsV0Guxu5bISoZ8GdfSFKf5gBAo97sGFeuUBMsHYPkcLehM1FmLZk1Q+ljcx3P1A/ds3kWXLolTXCrlpvNMBSN5NwOKAyhdPK/qkvnUrfX8sJ5XK2H4J8ECgYAGIZ0HIiE0Y+g9eJnpUFelXvsCEUW9YNK4065SD/BBGedmPHRC3OLgbo8X5A9BNEf6vP7fwpIiRfKhcjqqzOuk6fueA/yvYD04v+Da2MzzoS8+hkcqF3T3pta4I4tORRdRfCUzD80zTSZlRc/h286Y2eTETd+By1onnFFe2X01mwKBgQDaxo4PBcLL2OyVT5DoXiIdTCJ8KNZL9+kV1aiBuOWxnRgkDjPngslzNa1bK+klGgJNYDbQqohKNn1HeFX3mYNfCUpuSnD2Yag53Dd/1DLO+NxzwvTu4D6DCUnMMMBVaF42ig31Bs0jI3JQZVqeeFzSET8fkoFopJf3G6UXlrIEAQ==',
        ],
    ];
​
    public function index()
    {
        $config_biz = [
            'out_trade_no' => time(),
            'total_amount' => '1',
            'subject'      => 'test subject',
        ];
​
        $pay = new Pay($this->config);
​
        return $pay->driver('alipay')->gateway()->pay($config_biz);
    }
​
    public function return(Request $request)
    {
        $pay = new Pay($this->config);
​
        return $pay->driver('alipay')->gateway()->verify($request->all());
    }
​
    public function notify(Request $request)
    {
        $pay = new Pay($this->config);
​
        if ($pay->driver('alipay')->gateway()->verify($request->all())) {
            file_put_contents(storage_path('notify.txt'), "收到来自支付宝的异步通知\r\n", FILE_APPEND);
            file_put_contents(storage_path('notify.txt'), '订单号：' . $request->out_trade_no . "\r\n", FILE_APPEND);
            file_put_contents(storage_path('notify.txt'), '订单金额：' . $request->total_amount . "\r\n\r\n", FILE_APPEND);
        } else {
            file_put_contents(storage_path('notify.txt'), "收到异步通知\r\n", FILE_APPEND);
        }
​
        echo "success";
    }
}

xxxxxxxxxx
 
<?php
​
namespace App\Http\Controllers;
​
use Yansongda\Pay\Pay;
use Illuminate\Http\Request;
​
class PayController extends Controller
{
    protected $config = [
        'wechat' => [
            'app_id' => 'wxb3f6d0xxxxxxxd',
            'mch_id' => '1457768302',
            'notify_url' => 'http://yansongda.cn/wechat_notify.php',
            'key' => 'mF2suE9sU6Mkxxxxxxx5645645',
            'cert_client' => './apiclient_cert.pem',
            'cert_key' => './apiclient_key.pem',
        ],
    ];
​
    public function index()
    {
        $config_biz = [
            'out_trade_no' => 'e2',
            'total_fee' => '0.01',
            'body' => 'test body',
            'spbill_create_ip' => '14.213.156.207',
            'openid' => 'onkVf1FjWS5SBIihS-123456_abc',
        ];
​
        $pay = new Pay($this->config);
​
        return $pay->driver('wechat')->gateway('mp')->pay($config_biz);
    }
​
    public function notify(Request $request)
    {
        $pay = new Pay($this->config);
        $verify = $p->driver('wechat')->gateway('mp')->verify($request->getContent());
​
        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(storage_path('notify.txt'), "收到异步通知\r\n", FILE_APPEND);
        }
​
        echo "success";
    }
}

准备配置参数

xxxxxxxxxx
 
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
    ],
];
$config_biz = [
    'out_trade_no' => '12',         // 订单号
    'total_amount' => '13',         // 订单金额，单位：元
    'subject' => 'test subject',   // 订单商品标题
];

在代码中使用

xxxxxxxxxx
 
$pay = new Pay($config);
return $pay->dirver('alipay')->gateway('web')->pay($config_biz);

错误

使用非跳转接口（如 refund 接口、close 接口）时，如果在调用相关支付网关 API 时有错误产生，会抛出 GatewayException 错误，可以通过 $e->getMessage() 查看，同时，也可通过 $e->raw 查看调用 API 后返回的原始数据，该值为数组格式。

支付网关配置说明与返回值

由于支付网关不同，每家参数参差不齐，为了方便，我们抽象定义了两个参数：$config、$config_biz，分别为全局参数，业务参数。但是，所有配置参数均为官方标准参数，无任何差别。

「业务参数」为订单相关的参数，「全局参数」为除订单相关参数以外的全局性参数。

具体参数列表请查看每个支付网关的使用说明。

支付宝电脑网站支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
    ],
];
$config_biz = [
    'out_trade_no' => '12',                 // 订单号
    'total_amount' => '13',                 // 订单金额，单位：元
    'subject' => 'test subject',   // 订单商品标题
];

所有配置参数

所有参数均为官方标准参数，无任何差别（点击这里查看官方文档）：

xxxxxxxxxx
 
<?php
​
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
        'return_url' => '',         // 同步通知 url，*强烈建议加上本参数*
        'notify_url' => '',         // 异步通知 url，*强烈建议加上本参数*
    ],
];
$config_biz = [
    'out_trade_no' => '',
    'total_amount' => '',                 
    'subject' => '',
​
    // 订单描述
    'body' => '',
​
    // 订单包含的商品列表信息，Json格式： {"show_url":"https://或http://打头的商品的展示地址"} ，在支付时，可点击商品名称跳转到该地址      
    'goods_detail' => '',
​
    // 该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。 该参数数值不接受小数点， 如 1.5h，可转换为 90m。该参数在请求到支付宝时开始计时。
    'timeout_express' => '',                
​
    // 禁用渠道，用户不可用指定渠道支付当有多个渠道时用“,”分隔注：与enable_pay_channels互斥
    'disable_pay_channels' => '',
​
    // 可用渠道，用户只能在指定渠道范围内支付当有多个渠道时用“,”分隔注：与disable_pay_channels互斥
    'enable_pay_channels' => '',
​
    // 公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参数。支付宝只会在异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝
    'passback_params' => '',
​
    // 业务扩展参数，详见 [业务扩展参数说明](https://docs.open.alipay.com/#kzcs)
    'extend_params' => '',
​
    // 商品主类型：0—虚拟类商品，1—实物类商品（默认）注：虚拟类商品不支持使用花呗渠道
    'goods_type' => '',
​
    // 获取用户授权信息，可实现如免登功能。获取方法请查阅：用户信息授权
    'auth_token' => '',
​
    /**
     *  PC扫码支付的方式，支持前置模式和跳转模式。
     *
     *  前置模式是将二维码前置到商户的订单确认页的模式。需要商户在自己的页面中以iframe方式请求支付宝页面。具体分为以下几种：
     *  0：订单码-简约前置模式，对应iframe宽度不能小于600px，高度不能小于300px；
     *  1：订单码-前置模式，对应iframe宽度不能小于300px，高度不能小于600px；
     *  3：订单码-迷你前置模式，对应iframe宽度不能小于75px，高度不能小于75px；
     *  4：订单码-可定义宽度的嵌入式二维码，商户可根据需要设定二维码的大小。
     *
     *  跳转模式下，用户的扫码界面是由支付宝生成的，不在商户的域名下。
     *  2：订单码-跳转模式
     */
    'qr_pay_mode' => '',
​
    // 商户自定义二维码宽度 注：qr_pay_mode=4时该参数生效
    'qrcode_width' => ''
];

返回值

pay()

类型：string

说明：该接口返回跳转到支付宝支付的 HTML 代码。

支付宝手机网站支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
    ],
];
$config_biz = [
    'out_trade_no' => '12',                 // 订单号
    'total_amount' => '13',                 // 订单金额，单位：元
    'subject' => 'test subject',   // 订单商品标题
];

所有配置参数

该网关大部分参数和「电脑支付」相同，具体请参考官方文档

返回值

pay()

类型：string

说明：该接口返回跳转到支付宝支付的 HTML 代码。

支付宝 APP 支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'notify_url' => '',         // 支付宝异步通知地址
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
    ],
];
$config_biz = [
    'out_trade_no' => '12',                 // 订单号
    'total_amount' => '13',                 // 订单金额，单位：元
    'subject' => 'test subject',   // 订单商品标题
];

所有配置参数

该网关大部分参数和「电脑支付」相同，具体请参考官方文档

返回值

pay()

类型：string

说明：该接口返回用于客户端调用的 orderString 字符串，可直接供 APP 客户端调用，客户端调用方法不在此文档讨论范围内，Android 用户请看这里，iOS 用户请看这里。

支付宝刷卡支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
    ],
];
$config_biz = [
    'out_trade_no' => '12',         // 订单号
    'total_amount' => '13',         // 订单金额，单位：元
    'subject' => 'test subject',    // 订单商品标题
    'auth_code'  => '123456',       // 授权码
];

所有配置参数

该网关大部分参数和「电脑支付」相同，具体请参考官方文档

返回值

pay()

类型：array|bool

说明：该接口成功时返回服务器响应的数组；验签失败返回 false。

支付宝扫码支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'notify_url' => '',         // 支付宝异步通知地址
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
    ],
];
$config_biz = [
    'out_trade_no' => '12',                 // 订单号
    'total_amount' => '13',                 // 订单金额，单位：元
    'subject' => 'test subject',   // 订单商品标题
];

所有配置参数

该网关大部分参数和「电脑支付」相同，具体请参考官方文档

返回值

pay()

类型：string

说明：该接口返回二维码链接，可以通过其他库转换为二维码供用户扫描。

支付宝帐户转账

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
    ],
];
$config_biz = [
    'out_biz_no' => '',                      // 订单号
    'payee_type' => 'ALIPAY_LOGONID',        // 收款方账户类型(ALIPAY_LOGONID | ALIPAY_USERID)
    'payee_account' => 'demo@sandbox.com',   // 收款方账户
    'amount' => '10',                        // 转账金额
];

所有配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'alipay' => [
        'app_id' => '',             // 支付宝提供的 APP_ID
        'ali_public_key' => '',     // 支付宝公钥，1行填写
        'private_key' => '',        // 自己的私钥，1行填写
    ],
];
$config_biz = [
    'out_biz_no' => '',                      // 订单号
    'payee_type' => 'ALIPAY_LOGONID',        // 收款方账户类型(ALIPAY_LOGONID | ALIPAY_USERID)
    'payee_account' => 'demo@sandbox.com',   // 收款方账户
    'amount' => '10',                        // 转账金额
    'payer_show_name' => '未寒',             // 付款方姓名
    'payee_real_name' => '张三',             // 收款方真实姓名
    'remark' => '张三',                      // 转账备注
];

官方文档：https://doc.open.alipay.com/docs/api.htm?apiId=1321&docType=4

返回值

pay()

类型：array|bool

说明：该接口成功时返回服务器响应的数组；验签失败返回 false。

微信公众号支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'wechat' => [
        'app_id' => '',             // 公众号APPID
        'mch_id' => '',             // 微信商户号
        'notify_url' => '',
        'key' => '',                // 微信支付签名秘钥
        'cert_client' => './apiclient_cert.pem',        // 客户端证书路径，退款时需要用到
        'cert_key' => './apiclient_key.pem',            // 客户端秘钥路径，退款时需要用到
    ],
];
​
$config_biz = [
    'out_trade_no' => '',           // 订单号
    'total_fee' => '',              // 订单金额，**单位：分**
    'body' => '',                   // 订单描述
    'spbill_create_ip' => '',       // 支付人的 IP
    'openid' => '',                 // 支付人的 openID
];

所有配置参数

所有参数均为官方标准参数，无任何差别（点击查看官方文档）：

xxxxxxxxxx
 
<?php
​
$config = [
    'wechat' => [
        'app_id' => '',             // 公众号APPID
        'mch_id' => '',             // 微信商户号
        'notify_url' => '',
        'key' => '',                // 微信支付签名秘钥
        'cert_client' => './apiclient_cert.pem',        // 客户端证书路径，退款时需要用到
        'cert_key' => './apiclient_key.pem',            // 客户端秘钥路径，退款时需要用到
    ],
];
​
$config_biz = [
    'out_trade_no' => '',           // 订单号
    'total_fee' => '',              // 订单金额，**单位：分**
    'body' => '',                   // 订单描述
    'spbill_create_ip' => '',       // 支付人的 IP
    'openid' => '',                 // 支付人的 openID
​
    // 自定义参数，可以为终端设备号(门店号或收银设备ID)，PC网页或公众号内支付可以传"WEB"
    'device_info' => '',
​
    // 商品详细描述，对于使用单品优惠的商户，改字段必须按照规范上传，详见“单品优惠参数说明”
    'detail' => '',
​
    // 附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用。
    'attach' => '',
​
    // 符合ISO 4217标准的三位字母代码，默认人民币：CNY，详细列表请参见货币类型
    'fee_type' => '',
​
    // 订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。其他详见时间规则
    'time_start' => '',
​
    // 订单失效时间，格式为yyyyMMddHHmmss，如2009年12月27日9点10分10秒表示为20091227091010。其他详见时间规则注意：最短失效时间间隔必须大于5分钟
    'time_expire' => '',
​
    // 订单优惠标记，使用代金券或立减优惠功能时需要的参数，说明详见代金券或立减优惠
    'goods_tag' => '',
​
    // trade_type=NATIVE时（即扫码支付），此参数必传。此参数为二维码中包含的商品ID，商户自行定义。
    'product_id' => '',
​
    // 上传此参数no_credit--可限制用户不能使用信用卡支付
    'limit_pay' => '',
​
    // 该字段用于上报场景信息，目前支持上报实际门店信息。该字段为JSON对象数据，对象格式为{"store_info":{"id": "门店ID","name": "名称","area_code": "编码","address": "地址" }} ，字段详细说明请点击行前的+展开
    'scene_info' => '',
];

返回值

pay()

类型：array

说明：返回用于微信内H5调起支付的所需参数数组。后续调用不在本文档讨论范围内，具体请参考这里。

后续调用举例：

xxxxxxxxxx
 
<script type="text/javascript">
        function onBridgeReady(){
            WeixinJSBridge.invoke(
                'getBrandWCPayRequest', {
                    "appId":"<?php echo $pay['appId']; ?>",     //公众号名称，由商户传入     
                    "timeStamp":"<?php echo $pay['timeStamp']; ?>",         //时间戳，自1970年以来的秒数     
                    "nonceStr":"<?php echo $pay['nonceStr']; ?>", //随机串     
                    "package":"<?php echo $pay['package']; ?>",     
                    "signType":"<?php echo $pay['signType']; ?>",         //微信签名方式：     
                    "paySign":"<?php echo $pay['paySign']; ?>" //微信签名 
                },
                function(res){     
                    if(res.err_msg == "get_brand_wcpay_request:ok" ) {}     // 使用以上方式判断前端返回,微信团队郑重提示：res.err_msg将在用户支付成功后返回    ok，但并不保证它绝对可靠。 
                }
            ); 
        }
​
        $(function(){
            $('#pay').click(function(){
                if (typeof WeixinJSBridge == "undefined"){
                   if( document.addEventListener ){
                       document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false);
                   }else if (document.attachEvent){
                       document.attachEvent('WeixinJSBridgeReady', onBridgeReady); 
                       document.attachEvent('onWeixinJSBridgeReady', onBridgeReady);
                   }
                }else{
                   onBridgeReady();
                }
            })
        });
</script>

微信小程序支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'wechat' => [
        'miniapp_id' => '',             // 小程序APPID
        'mch_id' => '',             // 微信商户号
        'notify_url' => '',
        'key' => '',                // 微信支付签名秘钥
        'cert_client' => './apiclient_cert.pem',        // 客户端证书路径，退款时需要用到
        'cert_key' => './apiclient_key.pem',            // 客户端秘钥路径，退款时需要用到
    ],
];
​
$config_biz = [
    'out_trade_no' => '',           // 订单号
    'total_fee' => '',              // 订单金额，**单位：分**
    'body' => '',                   // 订单描述
    'spbill_create_ip' => '',       // 支付人的 IP
    'openid' => '',                 // 支付人的 openID
];

所有配置参数

由于「小程序支付」和「公众号支付」都使用的是 JSAPI，所以，除了 APPID 一个使用的是公众号的 APPID 一个使用的是小程序的 APPID 以外，该网关所有参数和「公众号支付」相同，具体请参考这里。

返回值

pay()

类型：array

说明：返回用于小程序调起支付API 的所需参数数组。后续调用不在本文档讨论范围内，具体请参考这里。

微信 H5 支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'wechat' => [
        'app_id' => '',             // 微信公众号 APPID
        'mch_id' => '',             // 微信商户号
        'return_url' => '',         // *此配置选项可选*，注意，该跳转 URL 只有跳转之意，没有同步通知功能
        'notify_url' => '',
        'key' => '',                // 微信支付签名秘钥
        'cert_client' => './apiclient_cert.pem',        // 客户端证书路径，退款时需要用到
        'cert_key' => './apiclient_key.pem',            // 客户端秘钥路径，退款时需要用到
    ],
];
​
$config_biz = [
    'out_trade_no' => '',           // 订单号
    'total_fee' => '',              // 订单金额，**单位：分**
    'body' => '',                   // 订单描述
    'spbill_create_ip' => '',       // 支付人的 IP
];

所有配置参数

所有配置项和前面支付网关相差不大，请点击这里查看。

返回值

pay()

类型：string

说明：返回微信支付中间页网址，可直接 302 跳转。

微信扫码支付

这里使用「模式二」进行扫码支付，具体请参考这里：https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_5

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'wechat' => [
        'app_id' => '',             // 微信公众号 APPID
        'mch_id' => '',             // 微信商户号
        'notify_url' => '',
        'key' => '',                // 微信支付签名秘钥
        'cert_client' => './apiclient_cert.pem',        // 客户端证书路径，退款时需要用到
        'cert_key' => './apiclient_key.pem',            // 客户端秘钥路径，退款时需要用到
    ],
];
​
$config_biz = [
    'out_trade_no' => '',           // 订单号
    'total_fee' => '',              // 订单金额，**单位：分**
    'body' => '',                   // 订单描述
    'spbill_create_ip' => '',       // 调用 API 服务器的 IP
    'product_id' => '',             // 订单商品 ID
];

所有配置参数

所有配置项和前面支付网关相差不大，请点击这里查看：https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_1

返回值

pay()

类型：string

说明：返回微信支付二维码 URL 地址，可直接将此 url 生成二维码，展示给用户进行扫码支付。

微信刷卡支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'wechat' => [
        'app_id' => '',             // 公众号 APPID
        'mch_id' => '',             // 微信商户号
        'key' => '',                // 微信支付签名秘钥
        'cert_client' => './apiclient_cert.pem',        // 客户端证书路径，退款时需要用到
        'cert_key' => './apiclient_key.pem',            // 客户端秘钥路径，退款时需要用到
    ],
];
​
$config_biz = [
    'out_trade_no' => '',           // 订单号
    'total_fee' => '',              // 订单金额，**单位：分**
    'body' => '',                   // 订单描述
    'spbill_create_ip' => '',       // 支付人的 IP
    'auth_code' => '',              // 授权码
];

所有配置参数

该网关所有参数和其它支付网关基本相同，具体请参考这里：https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=9_10&index=1

返回值

pay()

类型：array

说明：返回用于服务器返回的数组。返回参数请参考这里。

微信 APP 支付

最小配置参数

xxxxxxxxxx
 
<?php
​
$config = [
    'wechat' => [
        'appid' => '',              // APPID
        'mch_id' => '',             // 微信商户号
        'notify_url' => '',
        'key' => '',                // 微信支付签名秘钥
        'cert_client' => './apiclient_cert.pem',        // 客户端证书路径，退款时需要用到
        'cert_key' => './apiclient_key.pem',            // 客户端秘钥路径，退款时需要用到
    ],
];
​
$config_biz = [
    'out_trade_no' => '',           // 订单号
    'total_fee' => '',              // 订单金额，**单位：分**
    'body' => '',                   // 订单描述
    'spbill_create_ip' => '',       // 支付人的 IP
];

所有配置参数

该网关所有参数和其它支付网关相同相同，具体请参考这里。

返回值

pay()

类型：array

说明：返回用于小程序调起支付API 的所需参数数组。后续调用不在本文档讨论范围内，具体请参考这里。

在 Laravel 中使用

安装配置

还是通过 Composer 安装：

xxxxxxxxxx
 
composer require yansongda/laravel-pay

xxxxxxxxxx
 
Yansongda\LaravelPay\PayServiceProvider::class,

添加 alias：

xxxxxxxxxx
 
'Pay' => Yansongda\LaravelPay\Facades\Pay::class,

将配置文件发布到 config 目录：

xxxxxxxxxx
 
php artisan vendor:publish --provider="Yansongda\\LaravelPay\\PayServiceProvider" --tag=config

随后，请在 config 目录下完善配置信息。

使用方法

xxxxxxxxxx
 
use Pay;
​
$order = [
    'out_trade_no' => '1',
    'total_amount' => '1',
    'subject' => 'test subject',
];
​
return Pay::driver('alipay')->gateway('web')->pay(

代码贡献

由于测试及使用环境的限制，本项目中只开发了「支付宝」和「微信支付」的相关支付网关。

如果您有其它支付网关的需求，或者发现本项目中需要改进的代码，欢迎 Fork 并提交 PR！

感谢大家支持！

LICENSE

MIT

65 Comments

return $pay->driver('wechat')->gateway('scan')->pay($config_biz); 报错信息 Call to undefined method Yansongda\Pay\Pay::driver() 没有这个方法

我我我我也是这个问题请问怎么解决

请问大神，为什么我调用直接报错呢，谁可以帮帮我

In reply to #45

老哥，我都按照文档去做了，但是报错说类找不到

微信wap支付，<!DOCTYPE html> <html> <head> <meta charset="UTF-8" /> <meta http-equiv="refresh" content="0;url=https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx1417351533323772227992dd0168651477&package=2982547471&redirect_url=feature-88zhe-190510.hzapi.smallmitao.com" />

xxxxxxxxxx
 
<title>Redirecting to https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx1417351533323772227992dd0168651477&amp;package=2982547471&amp;redirect_url=feature-88zhe-190510.hzapi.smallmitao.com</title>
</head>
<body>
    Redirecting to <a href=" ">https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx1417351533323772227992dd0168651477&amp;package=2982547471&amp;redirect_url=feature-88zhe-190510.hzapi.smallmitao.com</a >.
</body>

</html>

return $pay->driver('alipay')->gateway()->pay($config_biz);报错Call to undefined method Yansongda\Pay\Pay::driver() 请问怎么解决

登录后即可添加评论

社交媒体登录认证提供者大全 —— Socialite Providers，支持微博、微信、QQ等

Laravel 5 中使用 JWT（Json Web Token） 实现基于API的用户认证

Laravel 生成 Gravatar 头像地址的优雅姿势

基于 access_token 的多用户多应用 API 认证 Laravel 开发包

在 Voyager 后台管理系统中集成 Entrust 实现 RBAC 权限管理（一） —— 安装

PHP -Casbin: 支持 ACL、RBAC、ABAC 多种模型的 PHP 权限管理框架

Laravel-Casbin：在 Laravel 里使用 Casbin（PHP 权限管理框架）

PHP 中基于 Casbin 做 RBAC + RESTful 权限控制

在 Laravel 5 中使用 Laravel Excel 实现 Excel/CSV 文件导入导出功能

使用 PhpSpreadsheet 实现读取写入 Execl

在 Laravel 中使用 Laravel Searchy 扩展包实现基于数据库的轻量级搜索功能

通过 Laravel 5 Extended Generators 扩展包为 Laravel 5 数据库生成器锦上添花

推荐：好用的 Laravel Repository 包

使用 laravel-repository 扩展包实现对模型类操作的封装

基于 Laravel Prequel 扩展包通过 Web 界面管理 MySQL 数据库

基于 Laravel 扩展包 laravel-db-snapshots 快速导入导出数据库快照

Laravel 调试利器 —— Laravel Debugbar 扩展包安装及使用教程

Laravel 5 中使用 HtmlBuilder 及 URL::asset() 引入站内或站外的 css 和 js 文件

为 Laravel 应用快速生成 HTML 导航菜单的扩展包：Laravel Menu

使用 Clockwork 扩展在 Chrome 浏览器中显示 Laravel 应用调试信息

Laraval IDE 自动补全助手：Laravel IDE Helper Generator

通过 Laravel EnvProviders 扩展包基于应用开发环境加载相应的服务提供者

在 Laravel 中通过 Artisan View 扩展包创建及删除应用视图文件

在 Laravel 5 中集成 Pjax 实现无刷新加载页面的扩展包 —— Laravel Pjax

使用 Laravel-Modules 扩展包通过模块化开发大型 Laravel 应用

基于 Laravel Sitemap 扩展包编写定时任务生成 Laravel 学院站点地图

Laravel 扩展包之开发辅助工具

基于 Laravel Sentry 扩展包实现 Laravel 学院异常实时监控及告警

基于 Laravel 扩展包 LaraStan 实现对项目代码的静态编译检查

基于 Laravel 扩展包 Health Monitor 在应用中实现资源及服务的健康检查和实时监控

使用 Laravel Telescope Toolbar 在浏览器工具条查看 Telescope 数据

在 Laravel 5 中集成七牛云存储实现云存储功能

优雅的 Oss Flysystem 扩展

在 Laravel 5 中通过 Simple QrCode 扩展包生成二维码详解

在 Laravel 5.1 中使用 Intervention Image 包将图片颜色变灰

在 Laravel 5 中集成 Intervention Image 实现对图片的创建、修改和压缩处理

在 Laravel 5 中使用 jQuery 插件 Croppic + Intervention Image 实现图片上传和裁剪

Laravel 5.1 中基于 Dropzone.js 实现图片拖拽上传及删除功能

使用 Laravel Generator 快速为 Laravel 应用生成CRUD、API、测试用例代码 —— 介绍篇

使用 Laravel Generator 快速为 Laravel 应用生成CRUD、API、测试用例代码 —— 安装篇

使用 Laravel Generator 快速为 Laravel 应用生成CRUD、API、测试用例代码 —— 使用篇

Laravel & Lumen RESTFul API 扩展包：Dingo API（一） —— 安装配置篇

Laravel & Lumen RESTFul API 扩展包：Dingo API（二） —— 创建 API Endpoint（路由）

Laravel & Lumen RESTFul API 扩展包：Dingo API（三） —— Response（响应）

Laravel & Lumen RESTFul API 扩展包：Dingo API（四） —— 错误和异常响应

Laravel & Lumen RESTFul API 扩展包：Dingo API（五） —— 转化器（Transformer）

使用 Lumen + Stormpath 为移动 App 提供后端 API

基于 Laravel 5.5 开发的适用于 API 开发的神器 —— laravel-smart

API 鉴权新姿势 - 签名鉴权扩展包：laravel-api-auth

API 鉴权新姿势 - 签名鉴权

使用 tree-ql 高效简洁的开发 API

使用 Laravel Moderation 扩展在 Laravel 应用中实现简单的内容审核系统

通过 Quarx 扩展包在任意 Laravel 应用中快速实现 CMS 功能

使用 Jigsaw 扩展包基于 Laravel Blade 模板构建静态站点 —— 安装预览篇

使用 Jigsaw 扩展包基于 Laravel Blade 模板构建静态站点 —— 环境变量篇

使用 Jigsaw 扩展包基于 Laravel Blade 模板构建静态站点 —— 视图布局篇

使用 Jigsaw 扩展包基于 Laravel Blade 模板构建静态站点 —— 前端编译篇

使用 Jigsaw 扩展包基于 Laravel Blade 模板构建静态站点 —— 站点部署篇

通过 Laravel Chatter 扩展包在十分钟内快速为应用搭建问答/论坛系统

基于 Laravel 扩展包 Wink 构建类 Medium 风格的内容发布系统

一款不错的开源 Laravel 后台面板/CMS系统 —— LaraAdmin

一款你不容错过的Laravel后台管理扩展包 —— Voyager

基于 Laravel-Admin 在十分钟内搭建起功能齐全的后台模板

Mojito admin - 基于 Laravel、Vue、Element 构建的基础后台系统扩展

Laravel-Admin 最全安装方法与汉化教程图解

Dcat Admin —— 一款颜值极高的后台系统构建工具，简单高效，开箱即用

通过 Nebula 扩展包构建基于 Laravel + Alpine + Tailwind 的后台管理系统

Laravel 5 表单中如何集成使用 Google reCAPTCHA 验证码

使用 Captcha 扩展包 为 Laravel 5 应用生成验证码

在 Laravel 5 中使用 Purifier 扩展包集成 HTMLPurifier 防止 XSS 跨站攻击

极限验证，一句话调用geetest，减少开发时间

极验(Geetest) Laravel 5 集成开发包，让验证更安全

使用 laravel-google-authenticator 扩展包为你的网站打造一个动态手机令牌

laravel使用laravel-google-authenticator拓展通过Google身份验证器为你的网站打造一个动态手机令牌

Laravel 学院文本编辑器及 XSS 攻击防范 —— 富文本编辑器 summernote 篇

Laravel 学院文本编辑器及 XSS 攻击防范 —— Markdown 编辑器篇

使用 Firewall 扩展包全面保护 Laravel 应用免受恶意攻击

Laravel 5 高性能电子商务扩展包 —— Aimeos Laravel

通过 ShoppingCart 扩展包在 Laravel 5.2 中快速实现购物车功能

laravel-amount —— Model 中自动转换金额的 Trait

Laravel 5 中使用 JWT（Json Web Token）实现基于API的用户认证

使用 Captcha 扩展包为 Laravel 5 应用生成验证码

SMProxy 1.2.9 发布！新增状态命令监控面板功能