laravelhungary / laravel-barion
Simple Laravel wrapper for the API of the Barion online payment system
Installs: 32 870
Dependents: 0
Suggesters: 0
Security: 0
Stars: 13
Watchers: 5
Forks: 7
Open Issues: 1
Requires
- php: >=5.6.0
- guzzlehttp/guzzle: ^6.2|^7.0
- illuminate/support: >=5.1
Requires (Dev)
- phpunit/phpunit: ^5.7
README
Use the Barion API with Laravel
Laravel-Barion is provides an easy way to use the Barion API with Laravel applications. Under the hood there is just a thin wrapper to make API calls simple.
Installation
- Install the package using composer:
composer require laravelhungary/laravel-barion
If you're using Laravel 5.5, you're done, the following steps are being done automatically.
- Register the service provider in the
app.php
config file
LaravelHungary\Barion\BarionServiceProvider::class,
- Register the Barion facade (optional)
'Barion' => LaravelHungary\Barion\BarionFacade::class
Configuration
Laravel-Barion comes preconfigured, you only need to set your POS key in the .env file:
BARION_POS_KEY=<my pos key>
The Barion environment defaults to test.barion.com
. To use the live instead,
set
BARION_LIVE_ENV=true
.
If you'd like to tweak the configuration values, publish the config file:
artisan vendor:publish --provider="LaravelHungary\Barion\BarionServiceProvider"
Usage
You can either resolve the Barion
class from the Service Container using Laravel's
dependency injection, or simply use the provided Facade.
There are two convenience methods for the two most-often used API calls:
Get the payment status
Barion::getPaymentState('my-payment-id')
Start a Payment
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 ] ] ] ] ])
All other API calls are accessible using either get
or post
:
Barion::get('/api/url')
Barion::post('/api/url', ['my-data' => 'some value'])
POS Key is automatically appended to each request.
License
Laravel-Barion is open source software licensed under the MIT License.