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 iDEAL (ING) as a Payment Method

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

With iDEAL (ING) only authorization with instant acquire is available. To cancel or refund a transaction you will have to use the iDEAL (ING) Dashboard. This is implemented with iDEAL (ING) Basic.

Settings in Ucommerce

Add a new payment method, under “Ucommerce –> Settings –> Orders –> Payment Methods”. You can call it whatever you like, here I have used “iDEAL (ING)”.

image

Click the newly created node and select “iDEAL (ING)” in the Service drop down list. Fill out the rest of the required information, like where it’s available from under the “Access” tab, pricing and the language tabs. When you are done click “Save”.

image

That’s everything in the Ucommerce interface.

Settings in iDEAL Dashboard

Changes needed in the iDEAL (ING) Dashboard, so it will work with Ucommerce.

Configure Secret Key

On the Menu on the left side, click “Signup process –> Configuration”. Make sure that there is a key in the “Secret key” field and the click “Start upload”. The “Certificate upload successful” should be marked with a green sign upon success.

image

Configure Return URLs

Ucommerce performs validation of the payment information when iDEAL (ING) performs the callback. To get the callback, for verify the payment, you need the set the “Notification” to XML and the “Notification URL” to you shops URL ending with “/PaymentMethodId/PaymentProcessor.axd”.

To find the PaymentMethodId you need to search the database. If you used the name “iDEAL (ING)” for the payment method name, you can run this SQL query in the SQL Server Management Studio:

select PaymentMethodId from Ucommerce_PaymentMethod where Name='iDEAL (ING)'

The URL could be then end with: “/10/PaymentProcessor.axd”.

image

Click “Start Upload” when you are done.

Editing the Ideal_Ing.config File

Now we need to edit the Ideal_Ing.config file.

You will find the Ideal_Ing.config file in the following location, where “rootdir” is the directory on the computer where you installed Umbraco: “rootdir\umbraco\UCommerce\Configuration\Ideal_Ing.config”. Usually “rootdir” is c:\inetpub.

image

Some of the below information are found in the iDEAL (ING) Dashboard, so start by logging in you aren’t already.

Finding secretKey

On the Menu on the left, click “Signup process” –> “Configuration”, here you will find the secretKey. Make sure that the “Certificate upload successful” is marked with a green sign, before you use it.

image

Finding merchantId

On the Menu on the left, click “Signup process” –> “Application”, here you will find the Merchant ID.

image

Finding subId

Unless agreed otherwise with the acquirer, you should use “0”(zero).

Finding successUrl, cancelUrl and errorUrl

To get the customer redirected back to your page after the payment is completed, you have to specify a return URL depending on payments result: Success, Error and Cancel.

Finding debug

If set to “True” you will be prompted to click a button before posting the information to “iDEAL” otherwise it will do an autosubmit using Javascript. When running in production, you will want this set to “false”.

Finding testMode

Test mode will toggle the payment method service to use a test environment where applicable. Usually this implies working against another URL.

Valid values “true” or “false”.

Finding language

Set preferred language, currently only “Dutch”(nl) is supported by remote gateway.

Executing a Pipeline on Callback

Running a pipeline once payment is authorized can be helpful if you need to complete the order once the customer returns to your site.

To run a “pipeline” once the callback if received and processed, open Umbraco click “Commerce” select the payment method (“iDEAL (ING)”). In the pipeline drop down list select Checkout and then click “Save”.

image

Now the default pipeline that comes with Ucommerce will be run after each successful callback. This sets the Basket to an Order, gives it an OrderNumber, and other things.

Configuring Auto Acquire and Cancel Payments

Authorize.Net comes with the ability to do automatic acquire and cancel payments. In order to make this work you need to enable a pipeline task.

To enable auto acquire edit the “ToCompletedOrder” pipeline.

To enable auto void/refund edit the “ToCancelled” pipeline.

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

image

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

FAQ

  • Test mode – Make sure test mode if turned off when going live.
  • You can simulate different payment statuses by using special amount on your payment. Please note that success payments can only be made with a payment total of 1 EUR.

Transactions made with any other amount than the ones below will result in an error:

  • Successful transaction: 1 EUR in test mode
  • Cancelled transaction: 2 EUR in test mode
  • Expired transaction: 3 EUR in test mode
  • Open transaction: 4 EUR in test mode
  • Format error: 7 EUR in test mode.