biscolab/laravel-gestpay

Laravel Gestpay Package (laravel-gestpay)

, _(*1)

Gestpay - Banca Sella payment libraries for Laravel 5 The easiest way to allow your customers to pay with their credit card their purchase on your website using Gestay - Banca Sella The documentation will be improved in the coming days, _(*2)

Liability limitations

, _(*3)

We are not and will not be responsible for any errors or problems caused by these files. Please read Gestpay's official documentation carefully before using this package., _(*4)

Installation

You can install the package via composer:, _(*5)

composer require biscolab/laravel-gestpay

The service provider must be registered in config/app.php:, _(*6)

'providers' => [
    ...
    Biscolab\Gestpay\GestpayServiceProvider::class,
];

You can use the facade for shorter code. Add "Gestpay" to your aliases:, _(*7)

'aliases' => [
    ...
    'Gestpay' => Biscolab\Gestpay\Facades\Gestpay::class,
];

Create config/gestpay.php configuration file using:, _(*8)

php artisan vendor:publish --provider="Biscolab\Gestpay\GestpayServiceProvider"

Configuration

Laravel configuration

Open config/gestpay.php configuration file and set shopLogin and uicCode:, _(*9)

return [
    'shopLogin'      => 'YOUR_SHOP_LOGIN',
    'uicCode'        => 'CURRENCY_CODE',
    'test'           => true // supported: true|false 
];

• shopLogin is the code that is assigned to your account
• uicCode is already set to 242 (Euro). You can find the complete list of currency codes here
• test if true it indicates that you are using your test account. More info at Using Gestpay payment page

For more information about shopLogin and uicCode please visit Gestpay - Creating your custom payment page, _(*10)

Gestpay configuration

Login to your Gestpay BackOffice account and set: - IP Address (your server IP, you can add more than one) - Response Address - URL for positive response (e.g. https://[yourdomain]/gestpay_callback/ok) - URL for negative response (e.g. https://[yourdomain]/gestpay_callback/ko), _(*11)

How to use

Ok, and now let's pay!

As always, paying is the easiest thing, _(*12)

gestpay()->pay($amount, $shopTransactionId);

That's all! - $amount: is the amount you have to pay - $shopTransactionId: is the unique identifier you have assigned to the transaction, _(*13)

I was joking, that's not all! Now you have to handle the callback. Based on the gestpay configuration, you now have to create the routes. For example, you can create a controller that handles callbacks through the method "gestpayCallback", _(*14)

    // e.g.
    Route::get('/gestpay_callback/{status}', ['uses' => 'GestpayController@gestpayCallback']);

Now, check whether the payment is succeeded. Gestpay response contains 2 parameters: a and b. gestpayCallback will be:, _(*15)

public function gestpayCallback($status){
    ...
    $gestpay_response = gestpay()->checkResponse();
}

$gestpay_response will be a GestpayResponse object. You can retrieve $gestpay_response properties using the following methods: - $gestpay_response->getTransactionResult() return transaction_result; should be true or false - $gestpay_response->getShopTransactionId() return shop_transaction_id; the $shopTransactionId you have sent through pay method - $gestpay_response->getErrorCode() return error_code; setting to "0" if the transaction is successful - $gestpay_response->getErrorDescription() return error_description; error code literal description in the language you have chosen, _(*16)

Then you can update your DB or everything you want!, _(*17)