Zum Hauptinhalt springen

Documentation

IMPORTANT

This is the outdated SI-documentation which will be adapted soon. A huge part may be obsolete!

Ingenico Payment Services

Payplans Ingenico supports *fixed*, *recurring* and *recurring + 1 trial* payment type.

Ingenico is a France-based company, providing seamless payment, smart, trusted and secure solutions, empowering commerce across all channels, in-store, online and mobile.

Payment Features

Currently Authorize CIM payment method supports the following payment features:

  • One-time Payments

  • Recurring Payments

  • Recurring + Trial Payments

  • Recurring Cancellation supported

Setting Up Ingenico

Ingenico requires user to register by clicking on Open a free test account button on Ingenico ePayment website and fill in a short form. After a short review by the team, you'll be receiving an email with a temporary password to login. Use the ID that you've choosen when you first registered together with the supplied password. Follow the designed step on account's homepage to complete the registration and activate your account.

PSP ID

Your PSP ID is the unique identifier for your entire gateway account. To find your PSP ID, simply login to the site and navigate to Configuration > Password. There, you'll find your PSP ID.

Ingenico

SHA Signature/Passphrase

The SHA signature/passphrase is a data integrity check, that guarantees no one can temper with the details of a transaction. You'll need to enter a passphrase, a character string of your own choice.

You may find SHA-IN passphrase at Configuration > Technical information > Data and origin verification.

Ingenico

And you may find SHA-OUT passphrase at Configuration > Technical information > Transaction feedback. Scroll down until you find Security for request parameters section.

Ingenico

Ingenico

  • SHA-IN passphrase : The SHA-IN verifies the data when they are submitted to the payment page. This is a mandatory check.

  • SHA-OUT passphrase : The SHA-OUT works the same as the SHA-IN, only it is used to verify the data after the transaction is processed.

Note: Please use a different passphrase in your production and development environment.

Ingenico Basic Settings

Please configure the following settings in order for Ingenico to be working correctly.

Default Operation Code

This option is located at Configuration > Technical Information > Global transaction parameters > Default Operation Code.

Ingenico

Processing for individual transactions

This option is located at Configuration > Technical Information > Global transaction parameters > Processing for individual transactions.

Ingenico

Hashing method

This option is located at Configuration > Technical Information > Global security parameters > Hashing method.

Ingenico

Back button redirection

This option is located at Configuration > Technical Information > Payment Page > Back button redirection. The URL should point to your site. Example: https://yoursite.com.

Ingenico

Checks for e-Commerce & Alias Gateway

This option is located at Configuration > Technical information > Data and origin verification > Checks for e-Commerce & Alias Gateway. The URL should point to your site. Example: https://yoursite.com.

Ingenico

Transaction Feedback

This option is located at Configuration > Technical information > Transaction Feedback > eCommerce. Make sure that:

  • [checked] I would like to receive transaction feedback parameters on the redirection URLs.
  • [unchecked] I would like 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.

Ingenico

Direct HTTP server-to-server request

This option is located at Configuration > Technical information > Transaction Feedback > Direct HTTP server-to-server request. Set URL of the merchant's post-payment page in both fields.

https://yoursite.com/index.php?option=com_payplans&view=payment&task=notify

Ingenico

Dynamic e-Commerce parameters

This option is located at Configuration > Technical information > Transaction Feedback > Dynamic e-Commerce parameters. Make sure that CREATION_STATUS, SUBSCRIPTION_ID and TRXDATE are selected.

Ingenico

Further information please read through Integrate with Ingenico ePayments e-Commerce.

Ingenico Configuration

Payment gateway integration guide can be read at New Payment Gateways Integration

The General options for Ingenico are fairly the same among all payment methods. You'll need to give a suitable title, determine whether to be published or unpublished and the appropriate description for this payment method. You may set this payment method to be applied on all plans or only on selected plans.

The following screenshot illustrate the options available in Ingenico.

Ingenico

The Parameters section are the specific options needed when configuring Ingenico integration. Details of each options are described below.

  • PSP ID : Enter your PSP ID provided by Ingenico in your account.

  • SHA-IN Pass Phrase : Enter the SHA-IN Pass Phrase which you have obtained from Ingenico.

  • SHA-OUT Pass Phrase : Enter the SHA-OUT Pass Phrase which you have obtained from Ingenico.

  • Allow Recurring Billing Cancellation : This option allows users to cancel their recurring billing on the front end when they are viewing their purchases.

  • Enable Sandbox Mode : This option determines if the payment gateway should be processed in sandbox mode. Sandbox is a testing environment simulates a behavior of a payment method.

When everything are in order, click on Save button to store the configuration.