Banca Sella PRO allows to connect the Magento checkout page with Gestpay. Gestpay PRO has three different integration modes:
- standard - the user will be redirected on Gestpay payment page, and will be afterwards redirected to the shop at the end of the transacion;
- iFrame - you can personalize every aspect of your payment page, like layout and language, with the advantage to let Gestpay handle sensitive credit card data;
- token - with this service, credit card data can be stored safely on Gestpay servers, and the users will be able to buy with just one click (like big online stores).
Banca Sella PRO has been tested with these versions:
Install via Magento Marketplace
On the admin sidebar, tap System. Then under Tools choose Web Setup Wizard.
Tap Component Manager. Then, click the Sign In link in the upper-right corner.
When prompted, paste the Public Access Key and Private Access Key from your Marketplace account. Then, tap Sign In .To learn more, see: Access Keys.
To synchronize Component Manager with your Marketplace purchases, tap Sync. It might take a few minutes. When the process is complete, the number of new purchases appears with the date and time the store was last synchronized.
In the Marketplace Purchases section under New Purchases, click Install. In the Extensions Grid, mark the checkbox of the extension you want to install. Then in the Action column, click the Install link for the item.
Install from zip file
Extract the content of the zip file on your hard disk.
In your Magento root directory, find the folder
code is missing, create it.
code, create the directories
BancaSellaPro, copy the content of the zip file: you should see
... folders along with
Then, launch this command (on mac and linux):
$ php bin/magento setup:upgrade
For the Windows platform, you shall write
php bin\magento setup:upgrade. From now on all commands will be specified for mac/linux.
The command will show a list of Magento2 modules. If you see
Module 'EasyNolo_BancaSellaPro': in the output, then the module has been installed.
After this, you need to re-compile and deploy static files with these commands:
$ php bin/magento setup:di:compile $ php bin/magento setup:static-content:deploy
After that extension should be ready for configuration in admin.
Once logged in in Magento, select Stores > Configuration > Sales > Payment methods and expand EasyNolo Banca Sella GestPay PRO section. Here is an example of the configuration section:
We will discuss now the single items.
|Enabled||If set on
|Payment Action||This option sets how the payment is processed by Gestpay. The choices are:
- Authorize Only: on payment, Gestpay only performs a transaction authorization.
- Authorize and Capture: on payment, Gestpay performs an authorization request together with the settlement of a transaction, using the Server-to-Server APIs if the setting Use S2S Sales API for Capture, Void, Refund actions is enabled. If on Gestpay Merchant Back-Office M.O.T.O. setting is set to contextuality between authorization and settlement, Magento Capture Offline will be performed.
|Title||The payment method title that will be shown to the user at checkout.|
|Description||A message shown in checkout before the user is redirected to Gestpay payment page.|
|Shop Login||The shop code given by Gestpay. It identifies the merchant.|
|Test Environment||If enabled, transactions are processed in the test environment. To use the test environment you must also set the Test Shop Login).|
|Gateway Language||The language to use in Gestpay payment page.|
|Gateway Currency||the currency to use for transactions. If the currency of the store is different from the one set in this configuration, the amount will be converted in the currency set, applying the exchange rate available in System > Manage Currency > Rates in Magento.|
|New Order Status||The status a Magento Order should get after a payment.|
|Status of order canceled by Banca Sella||by this setting you can choose the status of a cancelled order, if the payment is interrupted by Gestpay.|
|Status of order confirmed by Banca Sella||With this option you can set the status of an payed order.|
|Use S2S Sales API for Capture, Void, Refund actions||If enabled, Capture, Void and Refund features are directly integrated in Magento, so that you don’t have to access Gestpay Back-Office to do this.|
|Enable iFrame||This setting permits the user to pay directly on the store checkout page, without being redirected to Gestpay payment page.|
|Live payment URL||the production url for payments.|
|Live S2S URL||the production url for server-to-server calls.|
|Test payment URL||the test url for payments.|
|Test S2S URL||the test url for server-to-server calls.|
In Stores > Configuration > Sales > Payment methods you can choose:
- RED: when enabled, you can set this options:
- RISKIFIED: when enabled, you can set this options:
Alternative Payment methods
In Stores > Configuration > Sales > Payment methods > EasyNolo Banca Sella GestPay Pro Alternative Payments you can also decide which payment methods to enable (fo example Alipay integration, Klarna integration, Paypal integration, Sofort integration and other)
Merchant Back Office Configuration
In Configuration > Environment > Response Address, set your configuration like this:
- URL for positive response (mandatory): it is the URL to whom Gestpay redirects the user after the payment process, in case of success.
http://<< your domain >>/bancasellapro/gestpay/result
- URL for negative response (mandatory): it is the URL to whom Gestpay redirects the user after the payment process, in case of failure.
http://<< your domain >>/bancasellapro/gestpay/result
- URL Server to Server
http://<< your domain >>/bancasellapro/gestpay/s2s
If your store has store codes in the URL, put it in the response URL:
http://<< your domain >>/it_IT/bancasellapro/gestpay/s2s
Here the store code is
it_IT. The module will automatically identify the store where the purchase was made.
To enable the token feature you have to disable 3D secure security protocol. By disabling, the module can request the authorization on the credit card for recurrent payments. It’s not possible to use security protocols together with recurring payments.
You can disable 3D secure by asking Gestpay customer care.
Authorization and Settlement of a transaction
With M.O.T.O. configuration, Gestpay permits to separate the authorization and settlement phases. If enabled, the first transaction will be limited to the autorization request, else Gestpay will settle the amount immediately.
The plugin works accordingly to this configuration, implementing Gestpay S2S API for Settlement, Cancel and Refund. In case you are not using S2S services you have to manually settle the transaction in the merchant back office.
With the settlement operation the authorized amount will permanently be transferred to the merchant account. To use it, M.O.T.O. must be configured to separate the authorization from the settlement.
With this configuration Magento will create the order and, on checkout, it will block the necessary amount with the authorization operation (the merchant will receive an email from Gestpay).
When the shop administrator requests the invoice, Magento will ask Gestpay to settle the amount (and Gestpay will send an email to the merchant).
Cancelling a transaction occurs when you cancel an authorized transaction. It can be performed only with M.O.T.O. configured to separate authorization and settlement. It can be performed only on transactions that are not settled. This operations can be performed by Magento backend via the panel Sales > Orders, select from list an Order that you want to cancel and press View and than press Cancel.
Refund is the operation of refunding a settlement. From a fiscal point of view it is a charge on the merchant account and a credit on the buyer’s card. This operation can be performed only on altready settled transactions.
A settled transaction can be refunded partially and more than once, until the total of the original amount is reached. These operations are done from Magento using the control panel Sales > Orders, select from list an Order that you want to refund and press View and than press Credit memos. Now scroll down to find Refund Totals.