S'inscrire

Adapter: Ingenico ePayment

Ingenico is a globally active provider of payment solutions. Through its payment platform, customers in approximately 170 countries complete their purchases.

General Information

Ingenico is a globally active provider of payment solutions. Through its payment platform, customers in approximately 170 countries complete their purchases.

You can integrate Ingenico ePayment into zahls.ch via two options: E-COMMERCE and ALIAS GATEWAY. Setup for both variants is described below.

Country Availability

Ingenico’s payment solutions are available in approximately 170 countries worldwide.

Ingenico E-COMMERCE

General Information

Ingenico E-COMMERCE is Ingenico’s standard interface for processing online payments. As a merchant, you can connect your webshop to the system to process payments securely.

Features

Payment types

The following features are available in the zahls.ch dashboard:

  • ✅ One-time payment
  • ✅ Refund
  • ✅ Partial refund
  • ❌ Recurring payments (Subscription)
  • ❌ Tokenization
  • ❌ Pre-authorization

Payment methods

  • Visa
  • Mastercard
  • American Express
  • Diners Club International
  • Discover Card
  • Masterpass
  • Klarna
  • and many more

Setup

Please follow the instructions below to integrate Ingenico E-COMMERCE as an external payment provider in zahls.ch.

Configuration of zahls.ch

  • In the main menu of your zahls.ch account, navigate to Payment Providers.

  • Under "Credit Cards and Debit Cards", click on "Show":

  • Click the green Setup button next to Ingenico ePayments (E-Commerce):

  • Request a contract offer from Ingenico by clicking the green button:

  • Fill out the form and submit it.

  • Please make sure that the option "TPD | Dynamic Template" is activated by Ingenico.

  • You will receive an email from Ingenico with your login credentials.

  • In your zahls.ch account, go to Payment Providers, click "Show" under "Credit Cards and Debit Cards", and then click "Configure" next to Ingenico ePayments (E-Commerce).

  • Enable Test Mode (1) and select the appropriate package (2):

  • Enter the credentials you received from Ingenico into the corresponding fields and complete the configuration as follows:

  1. Select the payment methods you want to offer.
  2. Enable the currencies you wish to support.
  3. Fill in the fields under "test mode" with the data you received from Ingenico.

Configuration of Ingenico ePayment

  1. Navigate to Data and origin verification.
  2. Make sure the field "URL of the merchant page (...)" is left empty.
  3. Enter the corresponding value from your zahls.ch account into the "SHA-IN Signature" field:

Global transaction parameters

  • Navigate to Global transaction parameters.
  • Make sure your settings match those shown in the image below:

Global security parameters

  1. Navigate to Global security parameters.
  2. Make sure the selected hash algorithm matches the one configured in the Payment Provider Settings in your zahls.ch account.
  3. Additionally, enable the first option under "Character encoding":

Payment page

  • Navigate to Payment page.
  • Make sure the checkbox below "Cancel button" is unchecked, and the field below "Back button redirection" is left empty:

Transaction feedback

  1. Navigate to Transaction feedback.

  2. Make sure all input fields are left empty.

  3. Enable both checkboxes.

  4. In the Direct HTTP server-to-server request section, enable the option "Always online (...)".

  5. Copy the following URL into the field "If the payment's status is accepted (...)":
    https://dispatcher.zahls.ch/ogone/callback.php?result=-1

  6. Copy the following URL into the field "If the payment's status is cancelled (...)":
    https://dispatcher.zahls.ch/ogone/callback.php?result=-2

  7. Under "Request method", select POST:

  • Enable COMPLUS, PAYID, ORDERID, STATUS, and Dynamic E-Commerce Parameters.
  1. Enter the value for "SHA-OUT pass phrase" into the corresponding field. You can find this value in your zahls.ch account under Settings > Payment Providers > PostFinance, in the field labeled "SHA-OUT Signature".
  2. For the setting "HTTP request for status changes", select the option "No request" and save your changes:

Transaction emails

  • Navigate to Transaction emails.
  • Enter your email address under "Email address(es) for transaction-related emails" and click "Save".
  • Activate the payment option "Ogone by Ingenico" in your zahls.ch account.
  • Test the payment process in the zahls.ch frontend — for example, by using the Terminal.

Requesting live mode activation

  • Contact Ingenico ePayments to request activation of your account in live mode. To do so, send an email to admin.ecom@ingenico.com and include your PSPID.
  • Once you receive confirmation from Ingenico, log in to your zahls.ch account and navigate to Payment Providers.
  • Click "Configure" next to "Ingenico ePayments (E-Commerce)".
  • Verify the login credentials in the corresponding fields.
  • Enable Live Mode.

Configuring Masterpass

To configure the full checkout with Masterpass, you need the DirectLink product from Ingenico. For more information, please refer to the corresponding setup guide.

Ingenico ALIAS GATEWAY

General Information

Ingenico ALIAS GATEWAY is an extension of Ingenico E-COMMERCE, designed for the secure storage of payment data.

Instead of processing sensitive card information directly, an "alias" is created, which merchants can use for recurring payments or one-click checkouts.

Features

Payment types

The following features are available in the zahls.ch dashboard:

  • ✅ One-time payment
  • ✅ Refund
  • ✅ Partial refund
  • ✅ Recurring payments (Subscription)
  • ❌ Tokenization
  • ❌ Pre-authorization

Payment methods

  • Visa
  • Mastercard
  • American Express
  • Diners Club International
  • Discover Card
  • Masterpass
  • Klarna
  • and many more

Setup

Please follow the instructions below to integrate Ingenico ALIAS GATEWAY as an external payment provider in zahls.ch.

Configuration of zahls.ch

  • In the main menu of your zahls.ch account, navigate to Payment Providers.

  • Under "Credit Cards and Debit Cards", click on "Show":

  • Click the green Setup button next to Ingenico ePayments (Alias Gateway):

  • Request a contract offer from Ingenico by clicking the green button:

  • Fill out the form and submit it.

Configuration of Ingenico

After receiving an email from Ingenico, log in to your Ingenico account and activate the following options:

Minimum Requirements

  • OPC | One Page Checkout (Alias Gateway)
  • DPR | DirectLink (new payments)
  • USR1 | User Manager for up to 2 users

Optional

  • D3D | DirectLink 3D Secure
  • DMT | DirectLink (management)
  • DQY | DirectLink (inquiry)
  • RECX | Alias Manager

Configuration of zahls.ch

  • Log in to your zahls.ch account and enter the credentials you received from Ingenico via email.
  • Make sure that test mode is enabled.

Configuration of Ingenico

  1. Log in to the Ogone back office of Ingenico.
  2. Activate the payment method "Ogone Alias Gateway".
  3. Test the payment process on the frontend.
  4. Request activation for live mode from Ingenico by sending an email to Ogone, including your PSPID.
  5. Once you receive confirmation that live mode has been enabled, you can switch from test to production mode.

Configuration of the Ogone account

Basic configuration

Begin by setting up the basic configuration of your Ingenico (Ogone) account.

Adding required options

To use the zahls.ch Alias Gateway, you must purchase the options "One Page Checkout (OPC)" and "User Manager for up to 2 users (USR1)". Once activated, you can add an API user under Configuration > User Management by checking the box "Special user for API" when creating the user. The credentials of this user must then be entered accordingly in zahls.ch.

In the Ingenico back office, go to Configuration > Technical Information > Data and origin verification:

  1. In the section "Checks for DirectLink and Batch", leave the "IP address" field empty.
  2. In the "SHA-IN Signature" field, enter the signature defined in your zahls.ch backend. You can find this under Settings > Payment Providers > Ingenico ePayments (Alias Gateway).

Configuration of Masterpass

  • Log in to the Ingenico website using your credentials.
  • Navigate to Configuration > Technical Information > Transaction Feedback.
  • Under "DirectLink", move the "REDIRECTIONURL" and all "ECOM_" parameters to the right side of the screen.

Thèmes liés