PHPackages matthv/laravel-atos-sips-gateway - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. matthv/laravel-atos-sips-gateway ActiveLibrary[API Development](/categories/api) matthv/laravel-atos-sips-gateway ================================ Laravel Atos SIPS v1.1.0(4y ago)47831MITPHPPHP ^7.4|^8.0 Since Jan 31Pushed 4y ago1 watchersCompare [ Source](https://github.com/matthv/laravel-atos-sips-gateway)[ Packagist](https://packagist.org/packages/matthv/laravel-atos-sips-gateway)[ RSS](/packages/matthv-laravel-atos-sips-gateway/feed)WikiDiscussions 1.x Synced 3w ago READMEChangelogDependencies (1)Versions (4)Used By (0) Laravel Atos SIPS Payment ========================= [](#laravel-atos-sips-payment) --- This package makes easily integration with the Atos SIPS payment system, which is widely used by the french banks under different names: Mercanet, E-Transactions, Citelis, Sogenactif etc. **Be aware this package only supports the version 2 of Atos SIPS.** --- [Atos SIPS Official Documentation](https://documentation.sips.worldline.com/fr/WLSIPS.326-UG-Guide-de-demarrage-rapide.html) --- Installation ------------ [](#installation) ### 1. composer [](#1-composer) ``` composer require matthv/laravel-atos-sips-gateway ``` ### 2. publish [](#2-publish) ``` php artisan vendor:publish --provider="Matthv\AtosSipsGateway\Providers\AtosSipsServiceProvider" ``` ### 3. configuration [](#3-configuration) Most of the values come from the Atos dashboard. You should put the following variables into your .env file : - ATOS\_TEST : `true` to use test environment. Defaults to true. provided by Atos dashboard - ATOS\_MERCHANT\_ID : merchant id. - ATOS\_SECRET\_KEY : secret key. - ATOS\_KEY\_VERSION : key version. - ATOS\_INTERFACE\_VERSION : interface version. - ATOS\_PRODUCTION\_URL : bank production url. Defaults to `https://payment-webinit.mercanet.bnpparibas.net/paymentInit`. - ATOS\_TEST\_URL : bank test url. Defaults to `https://payment-webinit-mercanet.test.sips-atos.com/paymentInit`. You can see all configuration options in `config/atos.php`. #### Example using Mercanet BNP Paribas : [](#example-using-mercanet-bnp-paribas-) ``` ATOS_TEST=true ATOS_MERCHANT_ID=211000021310001 ATOS_SECRET_KEY=S9i8qClCnb2CZU3y3Vn0toIOgz3z_aBi79akR30vM9o ATOS_KEY_VERSION=1 ATOS_INTERFACE_VERSION=HP_2.20 ``` Documentation : [First-step](https://documentation.mercanet.bnpparibas.net/index.php?title=Premiers_pas) - [Dashboard-info](https://documentation.mercanet.bnpparibas.net/index.php?title=Obtenir_sa_cl%C3%A9_secr%C3%A8te) --- Usage ----- [](#usage) ### 1. Prepare the form payment [](#1-prepare-the-form-payment) To make a basic payment, you will need at least 2 information : - paymentNumber is used to identify individual transactions. This corresponds to Atos `transactionReference`. - The amount (integer formatted in cents). example 10.50 € => 1050. The default currency is Euro. **This code should be run in a controller. It will return a view which will automatically redirect the customer to the bank website.** ``` return app()->make(AtosSipsAuthorization::class) ->setPaymentNumber('AABBAA'.rand(1000,9999)) ->setAmount(1000) ->paymentView(); ``` You can add Atos SIPS custom fields with the `setCustomParameter` method. ``` return app()->make(AtosSipsAuthorization::class) ->setPaymentNumber('AABBAA'.rand(1000,9999)) ->setCustomParameters( [ 'customerEmail' => 'j.doe@customer-email.com', 'customerId' => 123, 'orderId' => 456, ] ) ->setAmount(1000) ->paymentView(); ``` ### 2. Return & callback routes [](#2-return--callback-routes) You need to set 2 routes names in `config/atos.php`, each with `post` method : - `customer_return_route_name` : allows your users to return to your site whenever the payment is successful or cancelled. Defaults to `atos.return`. - `customer_callback_route_name` : route called back by the bank on transaction completion. Defaults to `atos.callback`. You may need to exclude the routes from your VerifyCsrfToken middleware. ### 3. Callback transaction handling [](#3-callback-transaction-handling) This code should be run in controller of the callback route. ``` $verify = app()->make(Verify::class); // you can access all callback data using $allParameters = $verify->getParameters(); // or specify a field using $paymentNumber = $verify->getParameter('transactionReference'); try { $success = $verify->isSuccess(); if ($success) { // handle successful payment } else { // handle error payment } echo "OK"; } catch (InvalidSignature $e) { Log::alert('Invalid payment signature detected'); } ``` Licence ------- [](#licence) This package is licenced under the [MIT license](http://opensource.org/licenses/MIT) Thanks ------ [](#thanks) This package is inspired by [devpark/laravel-paybox-gateway](https://github.com/devpark/laravel-paybox-gateway). ### Health Score 30 — LowBetter than 62% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community10 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 87.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~189 days Total 3 Last Release 1599d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f24f44742bc3f79c56485cd11a8c507a558417a1d397cc0f0841bda5764fe430?d=identicon)[matthv](/maintainers/matthv) --- Top Contributors [![matthv](https://avatars.githubusercontent.com/u/10195400?v=4)](https://github.com/matthv "matthv (7 commits)")[![tech-codivores](https://avatars.githubusercontent.com/u/81105262?v=4)](https://github.com/tech-codivores "tech-codivores (1 commits)") --- Tags atos-sipslaravellaravel-paymentpayment-gatewaytransaction ### Embed Badge ![Health badge](/badges/matthv-laravel-atos-sips-gateway/health.svg) ``` [![Health](https://phpackages.com/badges/matthv-laravel-atos-sips-gateway/health.svg)](https://phpackages.com/packages/matthv-laravel-atos-sips-gateway) ``` ### Alternatives [statamic/cms The Statamic CMS Core Package 4.8k3.6M962](/packages/statamic-cms)[darkaonline/l5-swagger OpenApi or Swagger integration to Laravel 3.0k37.6M129](/packages/darkaonline-l5-swagger)[knuckleswtf/scribe Generate API documentation for humans from your Laravel codebase.✍ 2.3k14.2M62](/packages/knuckleswtf-scribe)[kyon147/laravel-shopify Shopify package for Laravel to aide in app development 485302.1k](/packages/kyon147-laravel-shopify)[statamic-rad-pack/runway Eloquently manage your database models in Statamic. 135224.7k7](/packages/statamic-rad-pack-runway)[scriptdevelop/whatsapp-manager Paquete para manejo de WhatsApp Business API en Laravel 783.8k](/packages/scriptdevelop-whatsapp-manager) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)