Documentation

Ucommerce includes full API reference documentation and lots of helpful articles to help you build your e-commerce site as effortlessly as possible.

Topics Payment Providers
v7.18

Setup Ucommerce to include OGone as a Payment Method

Ucommerce comes with built-in support for Ogone payments. This guide will walk you through getting Ucommerce to work with Ogone for payment processing.

With the Ogone payment provider you can do authorization of payments, instant acquire, acquire and perform refunds both via our automatic Ucommerce solution and manually via the back-end office of your Ogone subscription.

Settings in Ucommerce

Add a new payment method, under “Ucommerce à Settings à Orders à Payment Methods”, by right clicking the “Payment Methods” leaf and use “Create”. You can use any name you like; I have used “Ogone”.

image

Now we’re ready to configure your new payment method. Click the newly created node and select “Ogone” in the Service drop down list and select “Checkout” in the pipeline drop down list. Remember to fill out the rest of the required information in the rest of the Tabs.

When you’re done, click the save icon. That’s everything in the Ucommerce interface.

image

Settings in Your Back-end Office at Ogone

First you need to log in with your “pspid” and password.

image

Click “Technical information” at the menu to the left of the page. At the center screen 7 tabs is displayed. Use the settings as used on the screenshots representing each tab.

  1. Global Security Parameters

Set the first hash algorithm to SHA-1 as our system uses this hash algorithm for payment requests and maintenance requests.

Set the character encoding to the first option.

image
  1. Data and origin verification

You need a password in this field. This password is used in the communication between your Ucommerce shop and Ogone payment provider for security reasons. This pass phrase is used when the system requests a payment at Ogone.

The password must follow rules given by Ogone. Press the blue information button for information regarding those rules.

image
  1. Transaction feedback

The first four URLs in the “http redirection in the browser” section can be left blank, as we configure this in our configuration file later on.

The next step is to link from the secure payment page to your page which processes the payment.

Please note that “//PaymentProcessor.axd” is required at the end of your URL.

image

Next step is to tell Ogone which parameters they need to send back to our site. There’s quite a few available, just select them all. This is a good idea as that information is logged, should any problem occur, problem solving is made a lot easier.

image

The last part in this section is to put in the SHA-OUT pass phrase. This is the same method as before but for security reasons you should use another phrase this time.

When Ogone makes the callback to our server, this pass phrase is used in a hash algorithm in order to test for corrupt requests.

Now we need to make an “admin without user management” but with access rights to make direct link requests.

Click Users at the back end office menu to the left and click new users in that section.

image
image

Fill out the required fields and put your PSPID password in the password field and click create. At the next page you’ll get a password.

Now we need to change the password to something that doesn’t contain special characters (use “a-z” and/or “0-1”.

image

Under the password section, simply select the user you’ve just created and put in the old password and together with the new you want and click submit.

This is it in the back-end office at your configuration.

Configuring Acquire and Cancel Payments

The Ogone payment provider comes with the ability to do automatic acquire and cancel payments. In order to make this work you need to enable a pipeline task.

The pipeline configuration is found in /umbraco/ucommerce/pipelines.

image

Simply remove “” at the highlighted line. These are HTML comment sections.

Configuring the “Ogone.config” File

Now we need to edit the ”Ogone.config” file in order to match your environment.

You’ll find the configuration file at “rootdir\umbraco\UCommerce\Configuration\Ogone.config” where rootdir is the location on your computer, where Umbraco is installed.

Some values need to be found in the back-end office. All of those can be found under technical information.

image

Parameter list for the configuration file:

pspid

The pspId of your Ogone account.

Find it at the bottom of the menu to the left at the back-end office.

Userid

The Userid of the user you’ve just made.

Password

The password for the user you’ve just made.

acceptUrl

The URL the customer is redirected to after an accepted payment.

cancelUrl

The URL the customer is redirected to after a canceled payment.

backUrl

The URL the customer is redirected to if the customer clicks the back button on the payment page.

declineUrl

The URL the customer is redirected to if the payment is declined.

exceptionUrl

The URL the customer is redirected to if a problem occours in the payment process .

All the urls are a local webs in your website such as “yourshop.com/orderconfirmation.aspx”.

Debug

Tells the system whether this is in debug mode. This should be set to false.

shaSignOut

The shaSign used when Ogone redirects to the payment processor.

Under technical information, go to the bottom of the “transaction feedback” tab to find the SHA-OUT pass phrase

shaSignIn

The shaSign used when your Ucommerce website requests a payment at Ogone.

Under technical information, go to the “Data and origin verification” tab to find the SHA-IN pass phrase

language

Must follow the right language codes otherwise it’s set to the default value “en_US”.

instantAcquire

Is set to “true” if you want instant acquire.

Is set to “false” if you want to only authorize a payment.

testMode

Tells the system whether this is in test mode. This should be set to false.

Congratulations - your website now includes payments with the Ogone payment provider.