Sana Commerce 9.3
Your connector

Set up Ingenico Account

To configure the Ingenico payment provider and payment methods you should have the Ingenico test/live account with all the necessary data.

Configure the Ingenico payment provider in the Ingenico Back Office.

Step 1: Log in the Ingenico Back Office and click: Configuration > Technical information.

The table below provides the description of the settings that should be configured:

Global transaction parameters
Default operation code Select 'Sale'.
Processing for individual transactions Select 'Online but switch to offline in intervals when the online acquiring system is unavailable.'
Global security parameters
Compose the string to be hashed by concatenating the value of Select 'Each parameter followed by the passphrase.'
The option 'Main parameters only' is no longer supported for the new Ingenico accounts. But for the old accounts it is still present. This is because this option uses the older method of SHA encoding. Therefore, when you create a new Ingenico account, it is automatically set to 'Each parameter followed by the passphrase'.
Hash algorithm Select 'SHA-512' in order to comply with the highest data security standards. The selected value should match the value in Sana Admin.
Character encoding Select 'Use the character encoding expected with the initial transaction request (depending on the URL called)'.
Payment Page layout
No obligatory settings are required.
Data and origin verification
Checks for e-Commerce:
SHA-IN Pass phrase
Should match the [SHAInDeliminator] value in Sana Admin.
Transaction feedback
HTTP redirection in the browser
  • Check 'I want to receive transaction feedback parameters on the redirection URLs.'
  • Check 'I want Ingenico to display a short text to the customer on the secure payment page if a redirection to my website is detected immediately after the payment process.'
Direct HTTP server-to-server request
  • Always deferred (not immediately after the payment)': this option should be set only on the Beta/Live environment.
    The feedback request will be sent shortly after the end of the payment process.
  • 'Always online (immediately after the payment to allow customization of the response seen by the customer)': this option should be set only on the Test environment.
    The feedback request will be sent online sometime between Ingenico system's receipt of the acquirer's response and the time it notifies the customer of the payment result.
    In this case, the payment process takes longer for the customer, but the merchant can send a personalized response to the customer.
URL of the merchant's post-payment page Set full path to the payment confirmation page in both fields:
This path should be specified only for Beta/Live environment.
Request method Select 'POST'.
General Check 'I want Ingenico to re-launch the "end of transaction" (post-payment request/redirection) process if required.'
SHA-OUT Pass phrase Should match the [SHAOutDeliminator] value in Sana Admin.
HTTP request for status changes Check 'No request.'
Transaction e-mails
E-mails to the merchant Specify the e-mail addresses to which the information messages from Ingenico should be sent. Determine what type of messages you want to receive.
Test Info
Information about test card numbers or amounts are set on this tab.

Step 2: Configure the Ingenico payment methods in the Ingenico Back Office. Click: Configuration > Payment methods. Here you can setup the necessary payment methods.

Set up Alias

In order to use the extra checkout step with the customer's credit cards in the Sana web store, you need to set up alias in the Ingenico Back Office.

An alias is an identifier for a customer and his card or account information, which can be used to request future payments. Every alias is bound to a single merchant and cannot be used by a third party.

For more information about alias, see the official Ingenico documentation "Alias Manager (Tokenization)".

Step 1: Log in to the Ingenico Back Office and click: Configuration > Account > Your options.

On the Available options tab find the Alias Manager option and activate it.

Step 2: Click: Configuration > Technical information > Transaction feedback. In the Dynamic e-Commerce parameters section move the parameters ALIAS, BRAND and CARDNO from the Available box to the Selected box.

Then, in the Dynamic parameters section move the parameters ALIAS.ALIASID, CARD.BRAND and CARD.CARDNUMBER from the Available box to the Selected box. When the necessary parameters are moved, click Save.

If you need to see the list of all aliases, click Configuration > Alias > Alias list. In the Search by area set the parameters to find the necessary aliases.