cynolol/laravel-barion

Barion在线支付系统API的简单Laravel包装器

v1.3.1 2022-04-22 09:29 UTC

This package is auto-updated.

Last update: 2024-09-22 15:12:06 UTC


README

Travis StyleCI SensioLabs Insight license Packagist Total Downloads

Laravel-Barion为Laravel应用程序使用Barion API提供了一种简单的方法。底层只是一个薄的包装器,使API调用变得简单。

安装

  1. 使用composer安装此包

composer require laravelhungary/laravel-barion

如果您正在使用Laravel 5.5,您已完成,以下步骤将自动完成。

  1. app.php配置文件中注册服务提供者
LaravelHungary\Barion\BarionServiceProvider::class,
  1. 注册Barion外观(可选)
'Barion' =>  LaravelHungary\Barion\BarionFacade::class

配置

Laravel-Barion默认已配置,您只需要在.env文件中设置您的POS密钥

BARION_POS_KEY=<我的pos密钥>

Barion环境默认为test.barion.com。要使用实时环境,请设置

BARION_LIVE_ENV=true.

如果您想调整配置值,请发布配置文件

artisan vendor:publish --provider="LaravelHungary\Barion\BarionServiceProvider"

用法

您可以使用Laravel的依赖注入从服务容器中解析Barion类,或者简单地使用提供的外观。

有两个方便的方法用于最常用的API调用

获取支付状态

Barion::getPaymentState('my-payment-id')

启动支付

Barion::paymentStart([
    'PaymentType' => PaymentType::IMMEDIATE,
    'GuestCheckOut' => true,
    'FundingSources' => [FundingSource::ALL],
    'Locale' => Locale::HU,
    'Currency' => Currency::HUF,
    'Transactions' => [
        [
            'POSTransactionId' => 'ABC-1234',
            'Payee' => 'example@email.com',
            'Total' => 4990,
            'Items' => [
                [
                    'Name' => 'Example item',
                    'Description' => 'This is a sample description',
                    'Quantity' => 1,
                    'Unit' => 'db',
                    'UnitPrice' => 4990,
                    'ItemTotal' => 4990
                ]
            ]
         ]
    ]
])

所有其他API调用都可以通过getpost访问

Barion::get('/api/url')
Barion::post('/api/url', ['my-data' => 'some value'])

POS密钥将自动附加到每个请求。

许可证

Laravel-Barion是开源软件,受MIT许可证的许可。