Last update 6/09/2018

3. Configuration

3.1 Ingenico ePayments back office

Log on to your Ingenico ePayments back office to enter the required settings.

At your first log on to your account, you have to complete the following list of configuration steps for your test account:

  • Administrative details
  • Payment methods
  • Technical information
  • Request activation

Once your test account has been activated and you would like to change some details, you can still navigate to the various configuration pages via your Ingenico ePayments account menu.

3.1.1 Technical information

In order to get the extension up and running and to benefit from our support if needed, it’s important that you follow the steps as described below.

  1. Go to "Configuration" > "Technical Information" > "Data and origin verification":

    Data and origin verification tab
    1. In the "Checks for e-Commerce & Alias Gateway” section; fill in the "SHA-IN pass phrase" with the secret key of your choice. You will also have to set-up the same string in the PrestaShop back office. To verify the data that is submitted to our system, our Ingenico ePayments platform requires the SHA secure data verification method.

      Field Description
      SHASIGN Unique character string for order data validation. A string hashed with the SHA-1 algorithm will always be 40 characters long.
    2. Click the "Save" button.
  2. Select the "Global Transaction parameters" tab:
    1. In the "Default operation code" section; select "Sale".
    2. In the “Default data capture (payment) procedure" section; keep the first option, as this mechanism is not used with the PrestaShop extension.
    3. In the "Payment retry" section; we advise to change the value to 3 (instead of the default value of 10).
    4. In the “Processing for individual transactions” section; select “Online but switch to offline when the online acquiring system is unavailable”.
    5. Click the "Save" button.
  3. Select the "Global security parameters" tab:
    1. In the "Hashing method" section; select "SHA-1" for the "Hash algorithm" option and "UTF-8" for the "Character encoding" option.
    2. In the "Template" section; select "Yes" for the "Enable JavaScript check on template" option and “No” for the “Allow usage of static template” option.
    3. Click the "Save" button.
  4. Select the "Transaction feedback" tab:
    1. In the "e-Commerce - HTTP redirection in the browser" subsection:
      1. In each field for URL redirection (Accepturl, Declineurl, Exceptionurl, Cancelurl); fill in the same value "YOUR_SHOP_URL/modules/ogone/confirmation.php ".
      2. Select the "I would like to receive transaction feedback parameters on the redirection URLs" and "I would like Ingenico ePayments to display a short text to the customer on the secure payment page if a redirection to my website is detected ..." options.
    2. In the "e-Commerce - Direct HTTP server-to-server request" subsection:
      1. Select "Online but switch to a deferred request when the online requests fail.”
      2. In both fields for "URL of the merchant's post-payment page"; fill in the value "YOUR_SHOP_URL/modules/ogone/validation.php".
      3. Select "GET" as "Request method".
    3. In the "e-Commerce - Dynamic e-Commerce parameters" subsection; select all available parameters.

    4. In the “General” section; select I would like Ingenico ePayments to display a "processing" message to the customer during payment processing.
    5. In the "All transaction submission modes - Security for request parameters" subsection; fill in the "SHA-OUT pass phrase". The SHA-OUT pass phrase must be identical to the previously entered SHA-IN pass phrase.
    6. In the "All transaction submission modes - HTTP request for status changes" subsection; select "For each offline status change (payment, cancellation, etc.)." and fill in the value "YOUR_SHOP_URL/modules/ogone/validation.php".
    7. Click the "Save" button.
  5. Select the "Transaction e-mails" tab:

    In the "E-mails to the merchant" section; perform the following optional actions if you want to receive email for any transaction notification:

      1. Fill in your email address.
      2. Select "Yes, for all transaction submission modes" for the "Receive transaction confirmation e-mails" option.
      3. Select "Yes, for each offline status change (payment, cancellation, etc.)." for the "Receive e-mails in the event of offline transaction status changes" option.
      4. Click the "Save" button.
  6. Select the "Test info" tab.

    In the "Test info" section; select the "I would like to simulate transaction results based on the card number" option.

3.1.2 Module configuration-Ingenico

To use the advanced functionalities, DirectLink has to be activated and configured, and assign a dedicated user.


Tab Field Value Notes
Data and origin verification URL of the merchant page containing the
payment form that will call the page: orderstandard.asp
[EMPTY]


SHA-IN pass phrase



Checks for Ogone DirectLink and Ogone Batch (Automatic) [Server’s IP] Displayed on config page in Prestashop, tab “configuration” (on right)

SHA-IN pass phrase [PASSPHRASE]

Transaction feedback



Accepturl [http://shopurl.com]/modules/ogone/confirmation.php Urls are displayed in Prestashop BO, in sidebar in “Configuration” tab


Declineurl

[http://shopurl.com]/modules/ogone/confirmation.php

Urls are displayed in Prestashop BO, in sidebar in “Configuration” tab


Exception

[http://shopurl.com]/modules/ogone/confirmation.php

Urls are displayed in Prestashop BO, in sidebar in “Configuration” tab


Cancelurl

[http://shopurl.com]/modules/ogone/confirmation.php

Urls are displayed in Prestashop BO, in sidebar in “Configuration” tab
  I would like to receive transaction feedback parameters on the redirection URLs. [YES]  
Direct HTTP server-to-server request Timing of the request Online but switch to a deferred request when the online requests fail.  
  If the payment's status is "accepted", "on hold" or "uncertain". [http://shopurl.com]/modules/ogone/validation.php Urls are displayed in Prestashop BO, in sidebar in “Configuration” tab
  If the payment's status is "cancelled by the client" or "too many rejections by the acquirer". [http://shopurl.com]/modules/ogone/validation.php Urls are displayed in Prestashop BO, in sidebar in “Configuration” tab
  Request method GET  
  HTTP request for status changes For each offline status change (payment, cancellation, etc.).  
  URL on which the merchant wishes to receive a
deferred HTTP request, should the status of a transaction change offline.
[http://shopurl.com]/modules/ogone/validation.php Urls are displayed in Prestashop BO, in sidebar in “Configuration” tab
  Dynamic e-commerce parameters ACCEPTANCE
AMOUNT
BRAND
CARDNO
CURRENCY
NCERROR
ORDERID
PAYID
PM, STATUS
 
 

Alias gateway and Tokenization
Dynamic parameters

ALIAS.ALIASID
CARD.BRAND
CARD.CARDNUMBER
CARD.CARDHOLDERNAME
CARD.EXPIRYDATE
ALIAS.NCERROR
ALIAS.STATUS
ALIAS.STOREPERMANENTLY
If alias is needed
  General I would like Ogone to re-launch the "end of transaction"
(post-payment request/redirection) process if required.
 
  SHA-OUT pass phrase [PASSPHRASE]  
  HTTP request for status changes For each offline status change (payment, cancellation, etc.).  
  URL on which the merchant wishes to receive a deferred HTTP request, should the status of a transaction change offline. [http://shopurl.com]/modules/ogone/validation.php Urls are displayed in Prestashop BO, in sidebar in “Configuration” tab
  DirectLink
Dynamic parameters
ACCEPTANCE
ALIAS
AMOUNT
BRAND
CREATION_STATUS
CURRENCY
ECI
NCERROR
NCERRORPLUS
NCSTATUS
ORDERID
PAYID
PM
STATUS. SUBSCRIPTION_ID
VALID
VC
SCO_CATEGORY
SCORING
 

 

 

3.2 PrestaShop back office

Perform the following steps after the installation of the extension:

  1. Login to your PrestaShop back office.
  2. Go to "Module" > "Payment" > "Ingenico ePayments".
  3. Click on the “Configuration” tab.
  4. Select the option and fill in the following information.
Setting Description
PSPID Fill in the PSPID of your Ogone account. Verify if both accounts (Test and Production) are created.
SHA-IN Pass phrase Fill in the SHA-IN passphrase that you have setup in your Ingenico ePayments back office at "Technical information" > "Data and origin verification".
Attention: the SHA-IN passphrase can be different for Test and Production mode.
SHA-OUT Pass phrase Fill in the SHA-OUT passphrase that you have setup in your Ingenico ePayments back office at "Technical information" > "Transaction feedback".
Attention: SHA-OUT passphrase can be different for Test and Production mode.

Configuration of PrestaShop back office

3.2.1 Module configuration-PrestaShop

Note:

Additional information displayed in the modules configuration page are warning and error message for misconfigurations. There are four types of messages: error, warning, notification, and success.

For multi-store, configuration is bound to specific store context. Each store might require different configuration. A warning message will urge merchants to verify its accuracy if the configuration differs for each store.
As a leading global digital payment service provider, Ingenico Payment Services provides a seamless response to the complexity of payments, whatever the channel: online, mobile and point-of-sale. Offering innovative e-commerce, multi-channel, financial, and marketing solutions, it helps merchants to manage, collect and secure their payments, prevent fraud and increase their revenues through higher conversions. Ingenico Payment Services is part of the Ingenico Group, the global leader in seamless payment.

This website uses cookies to be able to give you the best user experience. If you don't want to accept these cookies, we allow you to change the cookie settings. Click 'Accept' to allow all cookies from this website.

Cookie settings

Introduction

Functional

Functional cookies are required for the website to operate correctly. These cookies cannot be disabled.

Optimized

Optimization cookies allow us to analyze site usage so we can measure and improve our website.
This is the default level.

Personalized

Personalization cookies are used for social media and advanced personalization. They allow us to show you information related to your company.


Example functionality allowed

  • Store country preference
  • Store language preference

Example functionality not allowed

  • Saving personal data
  • Anonymous tracking via Google Analytics
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics

Example functionality not allowed

  • Saving personal data
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics
  • Serve content relevant to your interests
  • Serve ads relevant to your interests
  • Tracking for remarketing purposes

Example functionality not allowed

  • Saving personal data