ignited/laravel-omnipay

Integerates Omnipay with Laravel and provides an easy configuration.

Omnipay for Laravel & Lumen

, _(*1)

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

Installation

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

composer require ignited/laravel-omnipay "3.*"

Note: You don't need to include the omnipay/common in your composer.json - it has already been included laravel-omnipay., _(*4)

Install Required Providers

Now just include each gateway as you require, to included PayPal for example:, _(*5)

composer require omnipay/paypal "3.*"

Alternatively you can include every gateway by the following:, _(*6)

composer require omnipay/omnipay "3.*"

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

Configuration

You can publish the configuration files using the vendor:publish command., _(*8)

php artisan vendor:publish --provider="Ignited\LaravelOmnipay\LaravelOmnipayServiceProvider" --tag=config

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

PayPal Express Example

Here is an example of how to configure password, username and, signature with paypal express checkout driver, _(*10)

...
'gateways' => [
    'paypal' => [
        'driver'  => 'PayPal_Express',
        'options' => [
            'username'  => 'coolusername',
            'password'  => 'strongpassword',
            'signature' => '',
            'solutionType' => '',
            'landingPage'    => '',
            'headerImageUrl' => '',
            'brandName' =>  'Your app name',
            'testMode' => true
        ]
    ],
]
...

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., _(*11)

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

Omnipay::setGateway('paypal');

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

dd($response->getMessage());

In addition you can make an instance of the gateway., _(*13)

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

Installation on Other Frameworks

Lumen

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

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

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

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

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

Guzzle

If you are using Guzzle 6 you need to require the following package., _(*17)

composer require php-http/guzzle6-adapter

Guzzle 7 now implements a PSR http client compliant adapter. So there is no need to include this., _(*18)

License

This package is open-sourced software licensed under the MIT license., _(*19)