xhat/payjs-laravel

基于 PAYJS 的 API 开发的 Composer Laravel Package,可直接用于生产环境 https://payjs.cn

Fund package maintenance!
payjs.cn/sponsor/dajjxz

1.6.0 2020-11-18 02:27 UTC

This package is auto-updated.

Last update: 2024-03-18 09:40:30 UTC


README

68747470733a2f2f7061796a732e636e2f7374617469632f696d616765732f6c6f676f2e706e67

PAYJS Wechat Payment Laravel Package

Latest Stable Version Total Downloads License

简介

本项目是基于 PAYJS 的 API 开发的 Laravel Package,可直接用于生产环境

PAYJS 针对个人主体提供微信支付接入能力,是经过检验的正规、安全、可靠的微信支付个人开发接口

其它版本: PAYJS 通用开发包

支持Laravel 5.x、Laravel 6.x、Laravel 7.x、Laravel 8.x

安装

通过 Composer 安装

$ composer require xhat/payjs-laravel

使用方法

一、发布并修改配置文件

  • 发布配置文件
php artisan vendor:publish --provider="Xhat\Payjs\PayjsServiceProvider"
  • 编辑配置文件 config/payjs.php 配置商户号和通信密钥
return [
    'mchid' => '', // 填写商户号
    'key'   => '', // 填写通信KEY
];

二、在业务中使用

首先在业务模块中引入门面

use Xhat\Payjs\Facades\Payjs;
  • 扫码支付
// 构造订单基础信息
$data = [
    'body' => '订单测试',                                // 订单标题
    'total_fee' => 2,                                   // 订单标题
    'out_trade_no' => time(),                           // 订单号
    'attach' => 'test_order_attach',                    // 订单附加信息(可选参数)
    'notify_url' => 'https://www.baidu.com/notify',     // 异步通知地址(可选参数)
];
return Payjs::native($data);
  • 收银台模式支付(直接在微信浏览器打开)
// 构造订单基础信息
$data = [
    'body' => '订单测试',                                    // 订单标题
    'total_fee' => 2,                                       // 订单金额
    'out_trade_no' => time(),                               // 订单号
    'attach' => 'test_order_attach',                        // 订单附加信息(可选参数)
    'notify_url' => 'https://www.baidu.com/notify',         // 异步通知地址(可选参数)
    'callback_url' => 'https://www.baidu.com/callback',     // 支付后前端跳转地址(可选参数)
];
$url = Payjs::cashier($data);
return redirect($url);
  • JSAPI模式支付
// 构造订单基础信息
$data = [
    'body' => '订单测试',                                    // 订单标题
    'total_fee' => 2,                                       // 订单金额
    'out_trade_no' => time(),                               // 订单号
    'attach' => 'test_order_attach',                        // 订单附加信息(可选参数)
    'openid' => 'xxxxxxxxxxxxxxxxx',                        // 订单附加信息(可选参数)
    'notify_url' => 'https://www.baidu.com/notify',         // 异步通知地址(可选参数)
];
return Payjs::jsapi($data);
  • H5支付
// 构造订单基础信息
$data = [
    'body' => '订单测试',                                    // 订单标题
    'total_fee' => 2,                                       // 订单金额
    'out_trade_no' => time(),                               // 订单号
    'attach' => 'test_order_attach',                        // 订单附加信息(可选参数)
    'notify_url' => 'https://www.baidu.com/notify',         // 异步通知地址(可选参数)
    'callback_url' => 'https://www.baidu.com',              // 前端跳转地址(可选参数)
];
return Payjs::mweb($data);
  • 投诉查询
// 构造订单基础信息
$data = [
    'mchid' => '123123',                                    // 商户号
];
return Payjs::complaint($data);
  • 查询订单
// 根据订单号查询订单状态
$payjs_order_id = '****************';
return Payjs::check($payjs_order_id);
  • 关闭订单
// 根据订单号关闭订单
$payjs_order_id = '****************';
return Payjs::close($payjs_order_id);
  • 退款
// 根据订单号退款
$payjs_order_id = '****************';
return Payjs::refund($payjs_order_id);
  • 获取商户资料
// 返回商户基础信息
return Payjs::info();
  • 获取用户资料
// 根据订单信息中的 OPENID 查询用户资料
$openid = '***************';
return Payjs::user($openid);
  • 查询银行名称
// 根据订单信息中的银行编码查询银行中文名称
$bank = '***************';
return Payjs::bank($bank);
  • 接收异步通知
// 接收异步通知,无需关注验签动作,已自动处理
$notify_info = Payjs::notify();
Log::info($notify_info);

更新日志

Version 1.5.0 增加投诉API、H5支付API

Version 1.4 修正空值参数的过滤问题

安全相关

如果您在使用过程中发现各种 bug,请积极反馈,我会尽早修复