README

免费 Laravel 包，帮助您与 vitepay.dev 集成

使用场景

使用 vitepay.dev 创建和管理软件
使用 vitepay.dev 管理设备
使用 vitepay.dev 创建和管理许可证

功能

从 config/vitepay.php 获取动态 vitepay.dev 凭据
通过几行代码轻松管理软件许可证

要求

PHP：8.1 或更高版本
Laravel 9.0 或更高版本

快速开始

如果您想将此包安装到自己的 Laravel 应用程序中，请按照以下安装步骤操作

安装

步骤 1. 如果您还没有，请安装一个 Laravel 项目

https://laravel.net.cn/docs/installation

步骤 2. 使用 composer 需要此包

composer require vitegroupltd/vitepay-laravel-integrate

步骤 3. 发布控制器文件和配置文件

php artisan vendor:publish --provider="ViteGroup\VitePay\VitePayServiceProvider" --tag="vitepay"

如果发布文件失败，请在路径 config/vitepay.php 和 app\Http\Controllers\VitePayControllers.php 上创建相应的文件。您还可以进一步自定义 VitePayControllers.php 文件以适应您的项目。

步骤 4. 更新已发布配置文件中的各种配置设置

发布包资源后，配置文件将位于 config/vitepay.php。请在 vitepay.dev 中找到这些值以填充到配置文件中。

步骤 5. 添加中间件保护

app/Http/Kernel.php

<?php

namespace App\Http;

use Illuminate\Foundation\Http\Kernel as HttpKernel;

class Kernel extends HttpKernel
{
    // Other kernel properties...
    
    /**
     * The application's route middleware groups.
     *
     * @var array
     */
    protected $routeMiddleware = [
        // Other middlewares...
         'vitepay' => 'App\Http\Middleware\VitePayMiddleware',
    ];
}

步骤 6. 添加路由

routes/api.php

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\VitePayController;

// Other routes properties...

Route::group(['middleware' => ['vitepay']], function () {
    Route::post('/vitepay/webhook', [VitePayController::class, 'webhook']);
});

}

然后您的 IPN (Webhook) URL 将类似于 https://yourdomain.ltd/api/vitepay/webhook，您应将其提供给 VitePay 的账户设置。如果您想将其提供到 routes/web.php，也可以，但请记住，VitePay 将检查与预注册 URL 匹配的 referer。因此，请确保您提供正确的网站 URL。

测试

<?php

namespace App\Console\Commands;

use GuzzleHttp\Exception\GuzzleException;
use ViteGroup\VitePay\VitePayTransactions;
use Illuminate\Console\Command;

class VitePayTestCommand extends Command
{
    protected $signature = 'vitepay:test';

    protected $description = 'Test VitePay SDK';

    public function __construct()
    {
        parent::__construct();
    }

    /**
     * @throws GuzzleException
     */
    public function handle()
    {
        $instance = new VitePayTransactions();
        print_r($instance->create(
            'INV-test-01',
            '',
            100000,
            'Description-test-01'
        ));
    }
}

RESTful API 文档

有关详细信息，请参阅 POSTMAN 文档

贡献

有关详细信息，请参阅贡献

安全

如果您发现任何安全相关的问题，请通过电子邮件 contact@ViteGroup.vn 或使用问题跟踪器

鸣谢

许可协议

MIT 许可协议 (MIT)。有关更多信息，请参阅许可文件

vitgroup ltd / vitepay-laravel-integrate

维护者

详细信息