关键词搜索

全站搜索
×
密码登录在这里
×
注册会员

已有账号? 请点击

忘记密码

已有账号? 请点击

使用其他方式登录

最优雅的支付宝和微信支付SDK详细文档手册-Yansongda Pay SDK

发布2020-11-07 浏览4579次

详情内容

概述

在开发了支付宝与微信支付后,看里面的api文档一团,很我方法都是自己写,找了很多网上没有好用的,能集成支付宝和微信支付的SDK,想在网上找相关的轮子,可是一直没有找到一款自己觉得逞心如意的,要么使用起来太难理解,要么文件结构太杂乱,只有自己撸起袖子干了。

  • 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 安装:

composer require yansongda/pay

使用说明:

支付宝

<?php

namespace App\Http\Controllers;

use Yansongda\Pay\Pay;
use Yansongda\Pay\Log;

class PayController
{
    protected $config = [
        'app_id' => '2016082000295641',
        'notify_url' => 'http://yansongda.cn/notify.php',
        'return_url' => 'http://yansongda.cn/return.php',
        'ali_public_key' => 'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuWJKrQ6SWvS6niI+4vEVZiYfjkCfLQfoFI2nCp9ZLDS42QtiL4Ccyx8scgc3nhVwmVRte8f57TFvGhvJD0upT4O5O/lRxmTjechXAorirVdAODpOu0mFfQV9y/T9o9hHnU+VmO5spoVb3umqpq6D/Pt8p25Yk852/w01VTIczrXC4QlrbOEe3sr1E9auoC7rgYjjCO6lZUIDjX/oBmNXZxhRDrYx4Yf5X7y8FRBFvygIE2FgxV4Yw+SL3QAa2m5MLcbusJpxOml9YVQfP8iSurx41PvvXUMo49JG3BDVernaCYXQCoUJv9fJwbnfZd7J5YByC+5KM4sblJTq7bXZWQIDAQAB',
        // 加密方式: **RSA2**  
        '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==',
        // 使用公钥证书模式,请配置下面两个参数,同时修改ali_public_key为以.crt结尾的支付宝公钥证书路径,如(./cert/alipayCertPublicKey_RSA2.crt)
        // 'app_cert_public_key' => './cert/appCertPublicKey.crt', //应用公钥证书路径
        // 'alipay_root_cert' => './cert/alipayRootCert.crt', //支付宝根证书路径
        'log' => [ // optional
            'file' => './logs/alipay.log',
            'level' => 'info', // 建议生产环境等级调整为 info,开发环境为 debug
            'type' => 'single', // optional, 可选 daily.
            'max_file' => 30, // optional, 当 type 为 daily 时有效,默认 30 天
        ],
        'http' => [ // optional
            'timeout' => 5.0,
            'connect_timeout' => 5.0,
            // 更多配置项请参考 [Guzzle](https://guzzle-cn.readthedocs.io/zh_CN/latest/request-options.html)
        ],
        'mode' => 'dev', // optional,设置此参数,将进入沙箱模式
    ];

    public function index()
    {
        $order = [
            'out_trade_no' => time(),
            'total_amount' => '1',
            'subject' => 'test subject - 测试',
        ];

        $alipay = Pay::alipay($this->config)->web($order);

        return $alipay->send();// laravel 框架中请直接 `return $alipay`
    }

    public function return()
    {
        $data = Pay::alipay($this->config)->verify(); // 是的,验签就这么简单!

        // 订单号:$data->out_trade_no
        // 支付宝交易号:$data->trade_no
        // 订单总金额:$data->total_amount
    }

    public function notify()
    {
        $alipay = Pay::alipay($this->config);
    
        try{
            $data = $alipay->verify(); // 是的,验签就这么简单!

            // 请自行对 trade_status 进行判断及其它逻辑进行判断,在支付宝的业务通知中,只有交易通知状态为 TRADE_SUCCESS 或 TRADE_FINISHED 时,支付宝才会认定为买家付款成功。
            // 1、商户需要验证该通知数据中的out_trade_no是否为商户系统中创建的订单号;
            // 2、判断total_amount是否确实为该订单的实际金额(即商户订单创建时的金额);
            // 3、校验通知中的seller_id(或者seller_email) 是否为out_trade_no这笔单据的对应的操作方(有的时候,一个商户可能有多个seller_id/seller_email);
            // 4、验证app_id是否为该商户本身。
            // 5、其它业务逻辑情况

            Log::debug('Alipay notify', $data->all());
        } catch (\Exception $e) {
            // $e->getMessage();
        }

        return $alipay->success()->send();// laravel 框架中请直接 `return $alipay->success()`
    }
}

微信

<?php

namespace App\Http\Controllers;

use Yansongda\Pay\Pay;
use Yansongda\Pay\Log;

class PayController
{
    protected $config = [
        'appid' => 'wxb3fxxxxxxxxxxx', // APP APPID
        'app_id' => 'wxb3fxxxxxxxxxxx', // 公众号 APPID
        'miniapp_id' => 'wxb3fxxxxxxxxxxx', // 小程序 APPID
        'mch_id' => '14577xxxx',
        'key' => 'mF2suE9sU6Mk1Cxxxxxxxxxxx',
        'notify_url' => 'http://yanda.net.cn/notify.php',
        'cert_client' => './cert/apiclient_cert.pem', // optional,退款等情况时用到
        'cert_key' => './cert/apiclient_key.pem',// optional,退款等情况时用到
        'log' => [ // optional
            'file' => './logs/wechat.log',
            'level' => 'info', // 建议生产环境等级调整为 info,开发环境为 debug
            'type' => 'single', // optional, 可选 daily.
            'max_file' => 30, // optional, 当 type 为 daily 时有效,默认 30 天
        ],
        'http' => [ // optional
            'timeout' => 5.0,
            'connect_timeout' => 5.0,
            // 更多配置项请参考 [Guzzle](https://guzzle-cn.readthedocs.io/zh_CN/latest/request-options.html)
        ],
        'mode' => 'dev', // optional, dev/hk;当为 `hk` 时,为香港 gateway。
    ];

    public function index()
    {
        $order = [
            'out_trade_no' => time(),
            'total_fee' => '1', // **单位:分**
            'body' => 'test body - 测试',
            'openid' => 'onkVf1FjWS5SBIixxxxxxx',
        ];

        $pay = Pay::wechat($this->config)->mp($order);

        // $pay->appId
        // $pay->timeStamp
        // $pay->nonceStr
        // $pay->package
        // $pay->signType
    }

    public function notify()
    {
        $pay = Pay::wechat($this->config);

        try{
            $data = $pay->verify(); // 是的,验签就这么简单!

            Log::debug('Wechat notify', $data->all());
        } catch (\Exception $e) {
            // $e->getMessage();
        }
        
        return $pay->success()->send();// laravel 框架中请直接 `return $pay->success()`
    }
}

准备配置参数

$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 = new Pay($config);
return $pay->dirver('alipay')->gateway('web')->pay($config_biz);

错误

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

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

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

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

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


支付宝电脑网站支付

最小配置参数

<?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',   // 订单商品标题
];

所有配置参数

所有参数均为官方标准参数,无任何差别(点击这里查看官方文档):

<?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 代码。

支付宝手机网站支付

最小配置参数

<?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 支付

最小配置参数

<?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 用户请看这里

支付宝刷卡支付

最小配置参数

<?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。

支付宝扫码支付

最小配置参数

<?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

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

支付宝帐户转账

最小配置参数

<?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',                        // 转账金额
];

所有配置参数

<?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。

微信公众号支付

最小配置参数

<?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
];

所有配置参数

所有参数均为官方标准参数,无任何差别(点击查看官方文档):

<?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调起支付 的所需参数数组。后续调用不在本文档讨论范围内,具体请参考这里

后续调用举例:

<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>

微信小程序支付

最小配置参数

<?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 支付

最小配置参数

<?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

最小配置参数

<?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 生成二维码,展示给用户进行扫码支付。

微信刷卡支付

最小配置参数

<?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 支付

最小配置参数

<?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 安装:

composer require yansongda/laravel-pay

注册 service provider:

Yansongda\LaravelPay\PayServiceProvider::class,

添加 alias:

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

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

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

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

使用方法

use Pay;

$order = [
    'out_trade_no' => '1',
    'total_amount' => '1',
    'subject' => 'test subject',
];

return Pay::driver('alipay')->gateway('web')->pay(

代码贡献

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

集成使用过程如果遇到l困难,联系QQ:44784009 解决SDK支付集成问题

点击QQ咨询
开通会员
上传资源赚钱
返回顶部
×
  • 微信支付
  • 支付宝付款
扫码支付
微信扫码支付
请使用微信描二维码支付
×

提示信息

×

选择支付方式

  • 微信支付
  • 支付宝付款
确定支付下载