Uname: Linux yisu-647059427c03a 3.10.0-862.14.4.el7.x86_64 #1 SMP Wed Sep 26 15:12:11 UTC 2018 x86_64
Software: nginx/1.22.1
PHP version: 7.3.31 [ PHP INFO ] PHP os: Linux
Server Ip: 103.146.158.90
Your Ip: 216.73.216.141
User: www (1000) | Group: www (1000)
Safe Mode: OFF
Disable Function:
passthru,exec,system,putenv,chroot,chgrp,chown,shell_exec,popen,proc_open,pcntl_exec,ini_alter,ini_restore,dl,openlog,syslog,readlink,symlink,popepassthru,pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,imap_open,apache_setenv

name : readme.md
<p align="center">
    <img src="https://payjs.cn/static/images/logo.png" width=80 />
</p>
<h2 align="center">PAYJS Wechat Payment Laravel Package</h2>
<p align="center">
  
   <a href="https://packagist.org/packages/xhat/payjs-laravel">
      <img src="https://poser.pugx.org/xhat/payjs-laravel/v/stable.png" alt="Latest Stable Version">
  </a> 
  
  <a href="https://packagist.org/packages/xhat/payjs-laravel">
      <img src="https://poser.pugx.org/xhat/payjs-laravel/downloads.png" alt="Total Downloads">
  </a> 
  
  <a href="https://packagist.org/packages/xhat/payjs-laravel">
    <img src="https://poser.pugx.org/xhat/payjs-laravel/license.png" alt="License">
  </a>
</p>

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

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

其它版本: [PAYJS 通用开发包](https://github.com/xhat/payjs)

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


## 安装

通过 Composer 安装

```bash
$ composer require xhat/payjs-laravel
```

## 使用方法

### 一、发布并修改配置文件

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

### 二、在业务中使用

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

```php
use Xhat\Payjs\Facades\Payjs;
```

- 扫码支付

```php
// 构造订单基础信息
$data = [
    'body' => '订单测试',                                // 订单标题
    'total_fee' => 2,                                   // 订单标题
    'out_trade_no' => time(),                           // 订单号
    'attach' => 'test_order_attach',                    // 订单附加信息(可选参数)
    'notify_url' => 'https://www.baidu.com/notify',     // 异步通知地址(可选参数)
];
return Payjs::native($data);
```

- 收银台模式支付(直接在微信浏览器打开)

```php
// 构造订单基础信息
$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模式支付

```php
// 构造订单基础信息
$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支付

```php
// 构造订单基础信息
$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);
```

- 投诉查询

```php
// 构造订单基础信息
$data = [
    'mchid' => '123123',                                    // 商户号
];
return Payjs::complaint($data);
```

- 查询订单

```php
// 根据订单号查询订单状态
$payjs_order_id = '****************';
return Payjs::check($payjs_order_id);
```

- 关闭订单

```php
// 根据订单号关闭订单
$payjs_order_id = '****************';
return Payjs::close($payjs_order_id);
```

- 退款

```php
// 根据订单号退款
$payjs_order_id = '****************';
return Payjs::refund($payjs_order_id);
```

- 获取商户资料


```php
// 返回商户基础信息
return Payjs::info();
```

- 获取用户资料

```php
// 根据订单信息中的 OPENID 查询用户资料
$openid = '***************';
return Payjs::user($openid);
```

- 查询银行名称

```php
// 根据订单信息中的银行编码查询银行中文名称
$bank = '***************';
return Payjs::bank($bank);
```

- 接收异步通知

```php
// 接收异步通知,无需关注验签动作,已自动处理
$notify_info = Payjs::notify();
Log::info($notify_info);
```

## 更新日志
Version 1.5.0
增加投诉API、H5支付API

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

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

© 2026 GrazzMean
https://ai.shandianfk.com/wp-sitemap-posts-post-1.xmlhttps://ai.shandianfk.com/wp-sitemap-posts-page-1.xmlhttps://ai.shandianfk.com/wp-sitemap-taxonomies-category-1.xmlhttps://ai.shandianfk.com/wp-sitemap-taxonomies-post_tag-1.xmlhttps://ai.shandianfk.com/wp-sitemap-users-1.xml