Magento 1.x

Gestpay PRO module permits to connect the Magento checkout page with Gestpay. Gestpay PRO has three different integration modes:

Note: At the moment the Token feature works only with Magento Recurrng Profile Payment feature.

Compatibility

Gestpay PRO has been tested with these versions:

Community Edition Enterprise Edition
1.7.0.2 1.12
1.8.1.0 1.13
1.9.2.4 1.14

The module is also compatible with IWD One Step / Page Checkout.

Install via Magento Connect Manager

From your admin page, go to System -> Magento Connect -> Magento Connect Manager:

Log in again if Magento Connect Manager asks you to do it.

Once in Magento Connect Manager, paste this extension key to install:

http://connect20.magentocommerce.com/community/EASYNOLOBANCASELLAPRO

And then click Proceed.

After clicking on Refresh at the bottom of the page, you should see the plugin correctly installed:

To see if the module is correctly installed select System > Configuration > Advanced > Advanced > and check that the option EasyNolo_BancaSellaPro is Enabled.

Gestpay PRO and IWD One Step / Page Checkout

if you use IWD One Step / Page Checkout (IWD_Opc), replace the content of the file EasyNolo_BancaSellaPro.xml inside app/etc/modules with EasyNolo_BancaSellaPro.xml.Onepage.bak. This way you’ll set the dependency to IWD_Opc the Gestpay PRO, and the two will work together.

Next, go to System -> Cache Management and refresh the cache.

Configuration

Once logged in in Magento, select System > Configuration > * Payment methods* and expand “Banca Sella Gestpay Pro” section. Here is an example of the configuration section:

We will discuss now the single items.

Option description
Enabled If set on Yes, this payment method is shown to the user in the payment page.
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).
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.
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 Payment Page This setting permits the user to pay directly on the store checkout page, without being redirected to Gestpay payment page.
Enable Tokenization Enables tokens for recurring payments.
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.
Status of order canceled by customer by this setting you can choose the status of a cancelled order, if the payment is interrupted by the user.
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.
Enable Anti-Fraud Check If enabled, the amount of the payment in Magento is verified against the amount of the proessed payment in Gestpay. If the payment doesn’t pass this check, the order gets the status Review Payment and Fraud.
Payment from Applicable Countries Filter by countries. If it’s set to Specific Countries, only users from countries selected in the configuration Authorized Countries will be allowed to use the payment method.
Sort Order Sets the order of this payment method against the others.
Enable log is yes, logs messages in EasyNolo_BancaSellaPro file in Magento directory var/log.

Merchant Back Office Configuration

In Configuration > Environment > Response Address, set your configuration like this:

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.

Language

If you select the language via the Gateway Language option, then you have to add the Parameter “Language” in the Merchant Back Office.

To do this, go in Payment Page > Fields & Parameters and then enable the parameter Language:

iFrame

The only prerequisite to use the iFrame in Gestpay is to publish the default payment page in Gestpay.

Token

To enable the Recurring Payment Profile in Magento you must enable Tokenization parameters, so that when the credit card is authorized for the first time, Gestpay will return a unique code for the card.

This token code can than be used in future transactions, until the due date of the subscription.

From Gestpay Back Office, in Payment Page > Fields & Parameters set the parameters in this way:

To enable the token feature you have to disable 3D secure security protocol. By disabling it, 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

Authorization request

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.

Settlement

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).

## Cancel

Cancelling a transaction occours 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 > Sales and orders > Orders, and from the order detail by clicking on “Void”.

Refund

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 and Sales > Invoices > Credit Note and clicking on Refund.

Internationalization

Labels for this module can be translated in every language, using Magento transaltion system based on CSV. You’ll find that the plugin already contains two languages:

Contacts

For every problem you can relate to Gestpay customer support at +39 015 243 4640 or ecommerce@sella.it.