Download the PHP package matthv/laravel-atos-sips-gateway without Composer
On this page you can find all versions of the php package matthv/laravel-atos-sips-gateway. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-atos-sips-gateway
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
Installation
1. composer
2. publish
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 :
Documentation : First-step - Dashboard-info
Usage
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.
You can add Atos SIPS custom fields with the setCustomParameter
method.
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 toatos.return
.customer_callback_route_name
: route called back by the bank on transaction completion. Defaults toatos.callback
.
You may need to exclude the routes from your VerifyCsrfToken middleware.
3. Callback transaction handling
This code should be run in controller of the callback route.
Licence
This package is licenced under the MIT license
Thanks
This package is inspired by devpark/laravel-paybox-gateway.