{"id":15106880,"url":"https://github.com/biscolab/laravel-gestpay","last_synced_at":"2025-09-27T05:31:24.283Z","repository":{"id":56950901,"uuid":"93932994","full_name":"biscolab/laravel-gestpay","owner":"biscolab","description":"Gestpay - Banca Sella payment libraries for Laravel 5","archived":true,"fork":false,"pushed_at":"2019-07-09T09:11:49.000Z","size":20,"stargazers_count":0,"open_issues_count":1,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-15T10:09:33.100Z","etag":null,"topics":["banca-sella","bancasella","gestpay","laravel","laravel-framework","laravel-gestpay","payment","payment-gateway","php","transaction"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/biscolab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-10T10:46:44.000Z","updated_at":"2023-01-28T16:59:20.000Z","dependencies_parsed_at":"2022-08-21T03:40:22.793Z","dependency_job_id":null,"html_url":"https://github.com/biscolab/laravel-gestpay","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biscolab%2Flaravel-gestpay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biscolab%2Flaravel-gestpay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biscolab%2Flaravel-gestpay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biscolab%2Flaravel-gestpay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/biscolab","download_url":"https://codeload.github.com/biscolab/laravel-gestpay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234391379,"owners_count":18824809,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["banca-sella","bancasella","gestpay","laravel","laravel-framework","laravel-gestpay","payment","payment-gateway","php","transaction"],"created_at":"2024-09-25T21:02:33.684Z","updated_at":"2025-09-27T05:31:18.960Z","avatar_url":"https://github.com/biscolab.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel Gestpay Package (laravel-gestpay)\n![Packagist version](https://img.shields.io/packagist/v/biscolab/laravel-gestpay.svg) [![Build Status](https://semaphoreci.com/api/v1/biscolab/laravel-gestpay/branches/v1/shields_badge.svg)](https://semaphoreci.com/biscolab/laravel-gestpay)\n\nGestpay - Banca Sella payment libraries for Laravel 5\nThe easiest way to allow your customers to pay with their credit card their purchase on your website using Gestay - Banca Sella\n**The documentation will be improved in the coming days**\n\n## Liability limitations\n[![MIT License](https://img.shields.io/github/license/biscolab/laravel-gestpay.svg)](https://github.com/biscolab/laravel-gestpay/blob/master/LICENSE)\n\nWe 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**.\n\n## Installation\n\nYou can install the package via composer:\n```sh\ncomposer require biscolab/laravel-gestpay\n```\nThe service **provider** must be registered in `config/app.php`:\n```php\n'providers' =\u003e [\n    ...\n    Biscolab\\Gestpay\\GestpayServiceProvider::class,\n];\n```\nYou can use the facade for shorter code. Add \"Gestpay\" to your aliases:\n```php\n'aliases' =\u003e [\n    ...\n    'Gestpay' =\u003e Biscolab\\Gestpay\\Facades\\Gestpay::class,\n];\n```\nCreate `config/gestpay.php` configuration file using:\n```su\nphp artisan vendor:publish --provider=\"Biscolab\\Gestpay\\GestpayServiceProvider\"\n```\n\n## Configuration\n\n### Laravel configuration\nOpen `config/gestpay.php` configuration file and set `shopLogin` and `uicCode`:\n```php\nreturn [\n    'shopLogin'      =\u003e 'YOUR_SHOP_LOGIN',\n    'uicCode'        =\u003e 'CURRENCY_CODE',\n    'test'           =\u003e true // supported: true|false \n];\n```\n- **shopLogin** is the code that is assigned to your account\n- **uicCode** is already set to 242 (Euro). You can find the complete list of currency codes [here](http://api.gestpay.it/#currency-codes)\n- **test** if true it indicates that you are using your test account. More info at [Using Gestpay payment page ](http://docs.gestpay.it/pay/using-banca-sella-payment-page.html)\n\nFor more information about **shopLogin** and **uicCode** please visit [Gestpay - Creating your custom payment page](http://docs.gestpay.it/pay/creating-your-custom-payment-page.html)\n\n### Gestpay configuration\nLogin to your **Gestpay BackOffice** account and set:\n- IP Address (your server IP, you can add more than one)\n- Response Address \n    -  URL for positive response (e.g. https://[yourdomain]/gestpay_callback/ok) \n    -  URL for negative response (e.g. https://[yourdomain]/gestpay_callback/ko)\n\n## How to use\n### Ok, and now let's pay!\nAs always, paying is the easiest thing\n```php\ngestpay()-\u003epay($amount, $shopTransactionId);\n```\nThat's all! \n- $amount: is the amount you have to pay\n- $shopTransactionId: is the unique identifier you have assigned to the transaction\n \nI was joking, that's not all! Now you have to handle the callback.\nBased 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**\"\n```php\n    // e.g.\n    Route::get('/gestpay_callback/{status}', ['uses' =\u003e 'GestpayController@gestpayCallback']);\n```\nNow, check whether the payment is succeeded. Gestpay response contains 2 parameters: a and b. `gestpayCallback` will be:\n```php\npublic function gestpayCallback($status){\n    ...\n    $gestpay_response = gestpay()-\u003echeckResponse();\n}\n```\n`$gestpay_response` will be a GestpayResponse object. You can retrieve $gestpay_response properties using the following methods:\n- `$gestpay_response-\u003egetTransactionResult()` return **transaction_result**; should be true or false\n- `$gestpay_response-\u003egetShopTransactionId()` return **shop_transaction_id**; the `$shopTransactionId` you have sent through `pay` method\n- `$gestpay_response-\u003egetErrorCode()` return **error_code**; setting to \"0\" if the transaction is successful\n- `$gestpay_response-\u003egetErrorDescription()` return **error_description**; error code literal description in the language you have chosen\n\nThen you can update your DB or everything you want!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiscolab%2Flaravel-gestpay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbiscolab%2Flaravel-gestpay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiscolab%2Flaravel-gestpay/lists"}