digitaldev-lx/laravel-eupago

一个用于通过 EuPago API 进行支付的 Laravel 扩展包。

v2.2.0 2024-07-20 16:01 UTC

README

laravel-eupago-repo-banner

Laravel EuPago

一个基于 CodeTech 的 laravel-eupago 扩展包,用于通过 EuPago API 进行支付的 Laravel 扩展包。感谢 CodeTech 团队。

Latest version GitHub license

要求

安装

在 Laravel 11 中安装 PHP 依赖

composer require digitaldev-lx/laravel-eupago

在 Laravel 10 中安装

composer require digitaldev-lx/laravel-eupago:2.1.0

发布迁移

php artisan vendor:publish --provider=DigitaldevLx\\LaravelEupago\\Providers\\EuPagoServiceProvider --tag=migrations

运行迁移

php artisan migrate

发布配置文件(可选)

php artisan vendor:publish --provider=DigitaldevLx\\LaravelEupago\\Providers\\EuPagoServiceProvider --tag=config

发布翻译文件(可选)

php artisan vendor:publish --provider=DigitaldevLx\\LaravelEupago\\Providers\\EuPagoServiceProvider --tag=translations

配置

环境

有两个环境可供您使用:"test" 和 "prod"。正如您所猜到的,您可以在应用的开发阶段使用 "test" 环境。当您的应用准备好投入生产时,切换到 "prod" 环境。

MB 参考

用法

创建 MB 引用的示例

use DigitaldevLx\LaravelEupago\MB\MB;

$order = Order::find(1);

$mb = new MB(
    $order->value, // foat
    $order->id, // integer
    $order->date, // Carbon::parse(now())->format('Y-m-d')
    $order->payment_limit_date, // Carbon::parse(now())->addDays(3)->format('Y-m-d')
    $order->value, // float
    $order->value, // float
    0 // allows duplicated payments
);

try {
    // Make the request to EUPago's API
    $mbReferenceData = $mb->create();

    if ($mb->hasErrors()) {
        // handle errors
    }
    
    // Make the request to EUPago's API
    $order->mbReferences()->create($mbReferenceData);
} catch (\Exception $e) {
    // handle exception
}

$referenceData 将包含有关支付的所有信息

[
    'success' => true,
    'state' => 0,
    'response' => "OK",
    'reference' => "000001236",
    'value' => "3.00000",
]

在需要生成 MB 引用的模型上使用 trait


use DigitaldevLx\LaravelEupago\Traits\Mbable;

class Order extends Model
{
    use Mbable;

检索 MB 引用

$order = Order::find(1);

$mbReferences = $order->mbReferences;

回调

该扩展包已处理回调,更新支付引用状态并触发 MBReferencePaid 事件。要处理 MB 引用,您需要将 mp 参数设置为 PC:PT


GET

/eupago/callback

####参数

MB 方式引用

用法

在需要生成 MB 方式引用的模型上使用 trait


use DigitaldevLx\LaravelEupago\Traits\Mbwayable;

class Order extends Model
{
    use Mbwayable;

检索 MB 方式引用

$order = Order::find(1);

$mbwayReferences = $order->mbwayReferences;

回调

该扩展包已处理回调,更新支付引用状态并触发 MBWayReferencePaid 事件。要处理 MB 引用,您需要将 mp 参数设置为 MW:PT

GET

/eupago/callback

####参数

许可证

digitaldev-lx/laravel-eupago 是开源软件,根据 MIT 许可证 发布。

关于 DigitalDev

DigitalDev 是一家位于葡萄牙里斯本的网络开发公司。我们专注于 Laravel、Livewire 和 Tailwind CSS。《a href="https://www.codeboys.pt" rel="nofollow noindex noopener external ugc">Codeboys 是我们的特殊合作伙伴,我们携手合作,为客户提供最佳解决方案。