Enable Payments Using the Ogone Payment Method

OVERVIEW

There are many payment gateways that can be used to accept payments from customers.  Ogone (now Ingenico) has several methods for you to use to do just that.  Hotcakes Commerce comes with both Always Online and the offline payment features available out of the box.  This allows you to choose whether you want to accept payments from customers on your site, or on Ogone's.  This article will cover the offline payment method.

REQUIREMENTS

The following pre-requisites will be necessary to accomplish the goals of this article:

GETTING STARTED

If you haven't done so already, create your Ogone account, or log into it so that you can access your account information easily.

ENABLING THE OGONE PAYMENT METHOD

HOTCAKES STORE ADMINISTRATION

In order to enable the Ogone payment method, you'll first need to be logged in and in your store administration area.  Once there, navigate to payment methods in the Settings menu.

Navigate to the Payment Method settings page

At this point, you can enable as many payment methods as you wish, but for now you should just check the Ogone payment method.  Don't forget to save your changes.

Check to enable Ogone, then click the Edit link

If you click the edit link next to Moneris, you'll be able to enter your payment settings that will allow Hotcakes and Moneris to communicate properly with each other. Saving your changes here should have your Moneris payment method working now, provided everything is enabled in the Moneris administration area too.

Enter the desired settings for the Ogone payment method

Setting Description
Payment Service Provider ID This is also known as the PSPID and it is the merchant ID you created when you opened your account with Ogone.
Hash Algorithm You have (3) options, SHA-1, SHA-256, and SHA-512.  The default is SHA-256. Choose any of the three, as long as it matches the Hash Algorithm setting in the Ogone administration.
SHA-IN Passphrase Follow the best practices supplied by Ogone and paste the SHA-IN passphrase from Ogone "Data and Origin Information" here.  It should not match the SHA-OUT passphrase.
SHA-OUT Passphrase Follow the best practices supplied by Ogone and paste the SHA-OUT passphrase from Ogone "Transaction Feedback" here.  It should not match the SHA-IN passphrase.
Template Page If you want to have a different display template on your Ogone payment page, put the name of the template here.  The template must exist using Ogone's administration in order for this to work.
Debug Mode When checked, this will log events about the payment method actions in the Event Viewer.
Developer Mode When checked, the test URL will be used instead of the production URL when processing payments.

OGONE ADMINISTRATION

Ogone has a few places where you need to set values to properly configure the Ogone administration.  For the most part, you'll configure Ogone how you want.  We'll only focus on the settings that are critical to Hotcakes.  You'll find these settings on the various tabs found in the Ogone administration area.

Setting Description
Hash Algorithm Ensure that the selected algorithm matches the one chosen in Hotcakes.
Hide the Cancel Button Optional. Set it or not, based upon your preference.
Back Button Redirection Do not set this value.  Hotcakes will do this for you dynamically on each request.
Checks for e-Commerce: URL of the Merchant Page... You can simply put the root of your URL here, such as https://mydomain.com
Checks for e-Commerce: SHA-IN Passphrase Ensure that this value matches the one entered in Hotcakes.
Checks for Ogone DirectLink and Ogone Batch Leave these fields blank.
HTTP redirection in the browser Leave these fields blank.  Hotcakes will do this for you dynamically on each request.
I would like to receive transaction feedback parameters on the redirection URLs. Checked.
Timing of the request No request.
If the payment's status is "accepted", "on hold" or "uncertain". Leave these fields blank.  Hotcakes will specify this for you dynamically on each request.
If the payment's status is "cancelled by the client" or "too many rejections by the acquirer". Leave these fields blank.  Hotcakes will specify this for you dynamically on each request.
Request method POST
Dynamic e-Commerce parameters You can have more selected, but at least select the following parameters:  ACCEPTANCE, AMOUNT, BRAND, CARDNO, CN, COMPLUS, CURRENCY, ED, IP, NCERROR, ORDERID, PAYID, PM, STATUS, TRXDATE.
Security for request parameters: SHA-OUT pass phrase Ensure that this value matches the one entered in Hotcakes.
HTTP request for status changes: Timing of the request No request.
Dynamic parameters You can have more selected, but at least select the following parameters:  NCERROR, ORDERID, PAYID, STATUS.

 

Have more questions? Submit a request

Need More Help?

Do you need more assistance with this article? Please review your support options.