The Ogone Ingenico package is based on  “Ogone e-commerce” and allows developers to simply add an Ogone Ingenico payment button that redirects the visitor to Ogone Ingenico and updates the payment and the order status in Magelia once the payment has been processed.

As NO credit card information is stored in Magelia WebStore, this approach really reduces the effort to provide PCI compliance.

• Requirements
  
  

• Magelia WebStore (3.0+)
• A responsive storefront based on the Magelia Responsive design template (3.0+) available here
• The code of the checkout page must not have been deeply changed
• An Ogone Ingenico merchant and/or sandbox account is required for configuration and tests.
  Click here to create an Ogone Ingenico account 

• 
  1.    Configure your Ogone Ingenico account
  
  

In order to allow communication between the Ogone Ingenico payment gateway and your Magelia responsive store front you will have to configure the following parameters in your Ogone Ingenico account:

• a.    The hash algorithm that will be used by the Ogone Ingenico payment gateway and the Responsive storefront to hash signatures that authenticate messages between each other.
  
  

  In your Ogone Ingenico account, please go to Configuration > Technical information > Global security parameters and select the hash algorithm of your choice:
  
  
  

  
  
  

  Once the parameters have been saved by clicking on the “SAVE” button at the end of the settings page, please indicate the hash algorithm you have chosen in the web.config file (hash parameter) as described in the next part of this documentation.

  
  
  b.    Origin URLs that should be accepted as referrer by the Ogone Ingenico payment page. Please indicate in the field displayed below all absolute public checkout URLs separated by ‘;’ that the responsive store front will use before redirecting customers to the Ogone Ingenico payment page :
  
  
  
  
  

  Please remember that by default the responsive store front uses localized URL so, if you have configured your store to manage multiple culture, you will have to specify in the field above all the localized checkout URLs in the various supported cultures.

  For example if you have configured your responsive store front to manage ‘en’ and ‘fr’ cultures you will have to specify two localized checkout URLs in the origin field :
  
  http://YourMageliaWebStorePublicUrl.com/en/Checkout;http://YourMageliaWebStorePublicUrl.com/fr/Checkout

  
  c.    The SHA-IN pass phrase must be specified in order to allow the Ogone Ingenico payment gateway to authenticate your responsive store front requests. This parameter is editable in the Configuration > Technical information > Global security parameters screen :
  
  
  
  

  Once parameters have been saved by clicking on the “SAVE” button at the end of the settings page, please indicate the SHA-IN pass phrase in the web.config file (shaIn parameter) as described in the next part of this documentation.
  
  
  

  d.   In order to get order status and payment updates when the Ogone Ingenico payment gateway processes payments please configure “Direct HTTP server-to-server request” fields available in the screen  Configuration > Technical information > Transaction feedback : 
  
  
  
  
  
  
  

  -       Choose the way that you want the Ogone Ingenico payment gateway to make requests to your responsive store front.

  -       Specify in both textbox the public URL of the Ogone Ingenico payment kit notification handler installed by the package using the following pattern : http://YourMageliaWebStorePublicUrl.com/Ogone/Notification

  -       Check the POST radio button as the Ogone Ingenico payment kit only accepts this HTTP verb to handle notifications.
  
  
  

  e.   The SHA-OUT pass phrase must be specified in order to allow the responsive store front to authenticate Ogone Ingenico notification requests. This parameter is editable in the Configuration > Technical information > Transaction feedback screen :
  
  
  
  
  

  Once parameters have been saved by clicking on the “SAVE” button at the end of the settings page, please indicate the SHA-OUT pass phrase in the web.config file (shaOut parameter) as described in the next part of this documentation.
  
  
  

  f.    In order to receive all HTTP requests for status changes please specify the URL of the Ogone Ingenico payment kit notification handler installed by the package according to this URL pattern: http://YourMageliaWebStorePublicUrl.com/Ogone/Notification. This parameter is editable in the Configuration > Technical information > Transaction feedback screen :
  
  
  
  

• 
  2.    Add information in the web.config
  
  

Once the package has been installed from your Magelia private repository, simply add the following  parameter keys to the <payments> section in the Web.config file of your Responsive Storefront:

• Controller=”Ogone”
• test: indicates if the payment gateway should the sandbox or not.
• PSPID: Your affiliation name in Ogone Ingenico system, chosen by yourself when opening your account with Ogone. This is a unique identifier and can’t ever be changed.
• hash: Hash algorithm of your choice in the Global security parameters of your Ogone Ingenico account. Accepted values are: SHA1, SH256 and SH512.
• shaIn: SHA-IN pass phrase of your choice in the Data and origin verification screen of your Ogone Ingenico account.
• shaOut: SHA-OUT pass phrase of your choice in the Transaction feedback screen of your Ogone Ingenico account.
• return-domain: Specify the root URL that will be used to generate customers returning URL from Ogone. It should be your public root URL.
• LOGO: Absolute URL of the logo that should be displayed on the payment page.
• TITLE: Title that should be displayed on the payment page.

Example of information added to the web.config file

Please find hereafter the complete list of parameters that could be specified in the web.config file in order to customize the Ogone Ingenico payment kit:

• 3.    Test and check
  
  

Once you have properly deployed the package, configured your Ogone Ingenico account and modified the web.config file, you should be able to see the Ogone Ingenico payment mode in the checkout page.

We suggest you to thoroughly test the website before you turn the Ogone Ingenico payment to live mode.