laravelhungary/laravel-barion

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

v1.4 2021-11-09 13:03 UTC

This package is auto-updated.

Last update: 2024-09-13 01:43:42 UTC


README

Stand With Ukraine

使用Laravel通过Barion API

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许可证授权。