README

Laravel TbcPay

此包允许您在Laravel应用程序中使用TBC支付。

目录

• 安装
• 交易类型
• 生成和放置证书
• 环境
• 配置
  • 金额单位
  • 商户URL
  • 调试
• 使用方法
  • 路由和控制器
  • 支付
  • 其他方法
  • 通过cron关闭营业日
• 交易历史
• 结果代码
• 信用

安装

composer require lotuashvili/laravel-tbcpay

适用于Laravel <= 5.4

如果您使用Laravel 5.4或更低版本，您需要在您的 config/app.php 文件中手动添加服务提供者。打开 config/app.php 并将 TbcPayServiceProvider 添加到 providers 数组中。

'providers' => [
    # Other providers
    Lotuashvili\LaravelTbcPay\TbcPayServiceProvider::class,
],

然后运行

php artisan vendor:publish --provider="Lotuashvili\LaravelTbcPay\TbcPayServiceProvider"

并运行迁移

php artisan migrate

交易类型（SMS / DMS）

此系统中存在两种交易类型： SMS 和 DMS。

SMS - 是一种直接支付方式，钱在1个事件中收费，一旦客户输入信用卡详情并点击继续。
DMS - 是一种两步法，首先事件在卡片上锁定资金（最多30天），第二次事件捕获资金（例如，当产品被发送给客户时进行第二次事件）。

每天，商户必须关闭营业日。

生成和放置证书

TBC以 .p12 格式提供SSL证书，我们需要将其转换为 .pem 格式。使用以下命令：

openssl pkcs12 -in *.p12 -out tbcpay.pem

转换后，将证书（.pem 文件）放置在 storage/certificates 文件夹中。可以取任何名字（例如此示例中的 tbcpay.pem）并在 .env 中指定名称和密码。

TBCPAY_CERTIFICATE_NAME=tbcpay.pem
TBCPAY_CERTIFICATE_PASS=YourPassword123

之后，将 storage/certificates 文件夹添加到您的 .gitignore。

环境

设置环境变量

注意：请指定证书文件名而不是完整路径。证书放置在 storage/certificates 文件夹中。

使用ISO 4217标准设置默认货币。所有货币列表：http://en.wikipedia.org/wiki/ISO_4217（默认为981 - GEL）。

TBCPAY_DEBUG=true
TBCPAY_CERTIFICATE_NAME=tbcpay.pem
TBCPAY_CERTIFICATE_PASS=YourPassword123
TBCPAY_DEFAULT_CURRENCY=981

配置

金额单位

您可以从配置或 .env 文件中更改默认金额单位。金额单位用于在发送请求到TBC之前乘以最终金额。TBC银行要求金额以分（或Tetri）为单位，而不是USD（或GEL）。

默认情况下，单位设置为100，因此您可以将金额以GEL的形式传递，例如 $amount = 300 将重定向到具有 300GEL 金额的结账页面。

如果将单位设置为 1，则将重定向到具有 3GEL 金额的结账页面。

要更改金额单位，请在 .env 文件中将 TBCPAY_AMOUNT_UNIT=1 设置为或在 config/tbc.php 中直接更改 amount_unit。

商户URL

如果有一天TBC更新了商户和提交URL，您只需简单地从 .env 或 config/tbc.php 中覆盖旧URL。

在 .env 中设置 TBCPAY_MERCHANT_URL 和 TBCPAY_FORM_URL 或直接在 config/tbc.php 中设置 merchant_url 和 form_url。

调试

只需通过在 .env 中设置 TBCPAY_DEBUG=true 启用调试，默认情况下所有日志都会在 tbc_logs 表中。您可以使用 Lotuashvili\LaravelTbcPay\Models\TbcLog 模型访问它们。

使用方法

设置路由和控制器

发布文件后，将创建 app/Http/Controllers/TbcPayController。请随意修改控制器。

打开 routes/web.php 并定义路由（移除变量以使用默认值）。

<?php

use Lotuashvili\LaravelTbcPay\TbcPay;

// Other routes

TbcPay::routes(
    $controller, // Default: 'TbcPayController'
    $successMethod, // Default: 'success'
    $failMethod // Default: 'fail'
);

注意：排除 tbcpay/* 路由的 CSRF Token 验证，以避免在成功/失败 URL 上出现 TokenMismatchException。

在您的 app/Http/Middleware/VerifyCsrtToken.php 中添加 URL。

<?php

class VerifyCsrfToken extends Middleware
{
    // Other variables

    protected $except = [
        'tbcpay/*',
    ];
}

将成功和失败 URL 发送给 TBC。

成功：http://website.ge/tbcpay/success

失败：http://website.ge/tbcpay/fail

支付

在您的控制器中注入 \Lotuashvili\LaravelTbcPay\TbcPay 类以使用支付。

<?php

class PaymentController
{
    // Other methods
    
    public function pay(\Lotuashvili\LaravelTbcPay\TbcPay $tbcPay)
    {
        // OPTIONAL: Load model and start transaction by model
        // Model relation will be used in tbc_transactions table
        $model = User::first();

        return $tbcPay->init(
            100, // Amount
            981, // Currency (Optional)
            'Biller name', // Name of biller (Optional)
            'Website payment', // Message to be displayed on a payment page (Optional)
            'ge' // Language of the payment page (Optional)
        )->start($model) // Model parameter is optional
         ->sms() // Optional: Specify transaction type (Supported: sms and dms)
         ->view(); // Return final view of TBC payment to redirect to a payment page
    }
}

返回视图后，网站将重定向到支付页面。填写卡详细信息后，您将重定向到您之前指定的成功或失败 URL。

使用其他方法

如果您已开始 DMS 授权（冻结账户上的资金），那么您必须在一段时间后实际对冻结金额进行收费。您需要 makeDms() 函数。

您可以直接通过调用例如 $tbcPay->reverse_transaction() 来访问核心处理器的方法（使用魔法 __call 函数）。请检查所有方法的 PlugAndPay TBC 处理器文档

通过cron关闭营业日

如果您在应用程序中没有运行 cron 作业，请参阅 Laravel 文档。

在您的 app/Console/Kernel.php 中注册命令。

protected $commands = [
    // Other commands
    \Lotuashvili\LaravelTbcPay\Commands\CloseDay::class,
];

然后将命令添加到计划任务中（例如，使用 daily()，它将在每天 00:00 运行命令）。

protected function schedule(Schedule $schedule)
{
    // Other commands
    $schedule->command('tbcpay:close-day')
             ->daily();
}

交易历史

默认情况下，所有交易都将在 tbc_transactions 表中可用。您可以使用 Lotuashvili\LaravelTbcPay\Models\TbcTransaction 模型访问它们。

如果您已启用 debug，则所有记录都将存储在 tbc_logs 表中，并且可以使用 Lotuashvili\LaravelTbcPay\Models\TbcLog 模型访问它们。

结果代码

信用

• Levan Lotuashvili
• Sandro Dzneladze - 插上即付
• 所有贡献者