Previous Topic

Next Topic

Configuring BancaSella Redirect Payment Plug-in

BancaSella redirect payment solution allows your customers to enter their credit card payments on the BancaSella secure page. To use the BancaSella redirect payment module, you need to set up the Merchant account with BancaSella. Please, visit the BancaSella website and contact their support to receive the information about merchants registration procedure.

After your Merchant account is set up, you will receive the unique identifier (Merchant ID), get the BancaSella payment server URL, and then you are ready to configure the BancaSella SSL payment plug-in provided in HSPcomplete.

The BancaSella plug-in implemented in HSPcomplete supports transactions of the Sale type - a single-step transaction without pre-authorization.

Important: The BancaSella Merchant Account Post-Configuration Required for the Plug-in to Work

After you enter the basic information into the HSPcomplete BancaSella plug-in configuration form (namely, your Merchant ID and BancaSella server URL), this is yet not all you should do to use the plug-in. Before activating the plug-in you must pass some additional information to the BancaSella payment gateway, which is required for the plug-in to establish connection with the gateway and receive the data about transactions processing results. To this effect, log in to the Merchant interface at the BancaSella website and specify the following:

  1. The callback URLs that will appear on the plug-in screen (view form, not for editing) after the required fields of the plug-in configuration form are filled. These URLs are shown in the Gateway-side settings part of the HSPcomplete BancaSella plug-in screen. Please copy these URLs and enter them into the relevant fields in the Configuration - Environment - Response screen of the Merchant Interface.
  2. The IP address of the computer that transactions will be sent from (i.e., the computer that runs your store). Go to Configuration -> Environment -> IP Address screen of the BancaSella Merchant Interface and enter this IP address.
  3. Only in case you have concluded an Advanced or a Professional Agreement with BancaSella, and would like to use all the features these agreement types provide (e.g., pass to the payment server some additional information about buyers at your store), you should set the buyer e-mail, name, and language, as parameters to be passed to the payment gateway in your Merchant account profile. To this effect, in the BancaSella Merchant interface, go to Consumer Conf->Fields&Parameters and mark Buyer E-Mail, Buyer Name, and Language as Parameters to be passed.

    Note: If you will configure the BancaSella plug-in to work in the Advanced or Professional Agreement mode, the plug-in will always try to fetch and pass the three buyer parameters mentioned above. And if it appears that the payment gateway it unable to accept these parameters (because your Merchant account was not configured properly) then transactions will be processed with the Error response.

To configure the BancaSella plug-in:

  1. Click the Edit button on the plug-in screen. Fill the form that appears:
    1. Type the BancaSella credit card payment server URL into the Server URL field (the default address is https://ecomm.sella.it/gestpay/pagam.asp).
    2. Enter your BancaSella Merchant account ID into the Merchant ID field.
    3. The Basic agreement box allows you to disable or enable sending a buyer e-mail, name, and language parameters by the plug-in to the payment gateway (and, generally speaking, without respect to the type of Agreement you have with BancaSella). If you have concluded the Basic Agreement with BancaSella, then you are to check the Basic agreement box in order to block the plug-in attempts to send these additional parameters, because the Basic Agreement does not support accepting additional parameters at the payment gateway side, and if the plug-in will try to do this, your transactions will return with Error response. If you have the Advanced or Professional agreement type, then you can also check the Basic agreement box if you just do not want the plug-in to sent the additional parameters to the payment gateway. And finally, if you have have the Advanced or Professional agreement type, you can leave the Basic Agreement box clear to pass buyers e-mail, name, and language parameters to the payment gateway, but in this case please do not forget to configure your BancaSella merchant account properly, as this described above in the notes on merchant account post-configuration, paragraph 3.
    4. If your Agreement with BancaSella allows using several currencies, then you can check the Multi-currencies support box to be able to use the system-wide currency other then the plug-in default currency (EUR).
    5. Key in the Button title. For example, this could be the name of payment system. This title will be displayed directly on the button for online-payment at HSPstore, on the final stage of subscription registration, when a customer selects how to pay for the services ordered.
    6. You can add both the short and the detailed description. Quick description of a payment method will be displayed below the button. The Long description of a payment method will be displayed in a separate section entitled Pay Online.
  2. Click the Update button.

Please send us your feedback on this help page