renedekat/laravel-omnipay

Integerates Omnipay with Laravel and provides an easy configuration.

Omnipay for Laravel 5 & Lumen

, _(*1)

Integrates the Omnipay PHP library with Laravel 5 via a ServiceProvider to make Configuring multiple payment tunnels a breeze!, _(*2)

Laravel 4 Support

For Laravel 4 see the version 1.x tree, _(*3)

Now using Omnipay 2.3/2.5

Version 2.0 and onwards has been updated to use Omnipay 2.3., _(*4)

Version 2.2 and onwards is using Omnipay 2.5, _(*5)

Composer Configuration

Include the laravel-omnipay package as a dependency in your composer.json:, _(*6)

"ignited/laravel-omnipay": "2.*"

Note: You don't need to include the omnipay/common in your composer.json - it is a requirement of the laravel-omnipay package., _(*7)

Omnipay recently went refactoring that made it so that each package is now a seperate repository. The omnipay/common package includes the core framework. You will then need to include each gateway as you require. For example:, _(*8)

"omnipay/eway": "*"

Alternatively you can include every gateway by requring:, _(*9)

"omnipay/omnipay": "*"

Note: this requires a large amount of composer work as it needs to fetch each seperate repository. This is not recommended., _(*10)

Installation

Run composer install to download the dependencies., _(*11)

Laravel 5

Add a ServiceProvider to your providers array in config/app.php:, _(*12)

'providers' => [

    'Ignited\LaravelOmnipay\LaravelOmnipayServiceProvider',

]

Add the Omnipay facade to your facades array:, _(*13)

    'Omnipay' => 'Ignited\LaravelOmnipay\Facades\OmnipayFacade',

Finally, publish the configuration files via php artisan vendor:publish., _(*14)

Lumen

For Lumen add the following in your bootstrap/app.php, _(*15)

$app->register(Ignited\LaravelOmnipay\LumenOmnipayServiceProvider::class);

Copy the laravel-omnipay.php file from the config directory to config/laravel-omnipay.php, _(*16)

And also add the following to bootstrap/app.php, _(*17)

$app->configure('laravel-omnipay');

Configuration

Once you have published the configuration files, you can add your gateway options to the config file in config/laravel-omnipay.php., _(*18)

Usage

$cardInput = [
    'number'      => '4444333322221111',
    'firstName'   => 'MR. WALTER WHITE',
    'expiryMonth' => '03',
    'expiryYear'  => '16',
    'cvv'         => '333',
];

$card = Omnipay::creditCard($cardInput);
$response = Omnipay::purchase([
    'amount'    => '100.00',
    'returnUrl' => 'http://bobjones.com/payment/return',
    'cancelUrl' => 'http://bobjones.com/payment/cancel',
    'card'      => $cardInput
])->send();

dd($response->getMessage());

This will use the gateway specified in the config as default., _(*19)

However, you can also specify a gateway to use., _(*20)

Omnipay::setGateway('eway');

$response = Omnipay::purchase([
    'amount' => '100.00',
    'card'   => $cardInput
])->send();

dd($response->getMessage());

In addition you can take an instance of the gateway., _(*21)

$gateway = Omnipay::gateway('eway');