Webshop Installation

Webshop module installation

This part is the install manual for the webshop module, which will be made public in the near future.

Module install

The first step is to copy the demo webshop template directory <GO path>/modules/webshop/install/templates/webshop-demo to <GO path>/modules/cms/templates. This has to be done because there can be only one template directory, which is the one in the cms directory.

The webshop module won't work without the billing and website (cms) modules. Ensure that these are installed first before installing the webshop module. After the webshop module installation in the GO module management module, do the usual GO restart that usually has to be done after each new module installation.

At this point, you can already view the demo webshop and its contents. The webshop and webshop page contents can be managed in the website (cms) module, just like any other site managed using the cms module. Note the new button 'webshop' on the right side of the toolbar. This lets you configure the webshop. The most important webshop settings are to which site and to which product category root the webshop is linked. You can select any category, made in the billing module's catalog dialog, as root.

Set payment methods

To add a new way customers can pay you, first go to the Payments tab of the webshop dialog. You can add the new payment methods you want here, such as iDeal and Multipay. Apart from doing the GO configurations for your webshop payment methods, you also have to make the necessary arrangements with your own bank, for which we will give some general guidelines.

In the webshop dialog form, you should set the Order Book to Webshop Orders, and the Order Statuses to their respective settings of the same names.

iDeal

All the selectable iDeal payment methods end with 'ik', e.g. 'rik' for Rabobank InternetKassa and 'abnamro_ik' for ABN-AMRO InternetKassa. It is advised to only use the iDeal payment method with a bank with which you have an account. As for the GO configurations, double-click on the newly added iDeal payment method in the payment method panel to call the payment method form, and add the following lines in the 'options' textarea, making your own individual adjustments:

<options><PSPID>Your personal iDeal ID</PSPID>
<language>EN</language>
<currency>EUR</currency>
<SHA1in_key>A code of at least 16 characters.</SHA1in_key>
<SHA1out_key>Another code of at least 16 characters.</SHA1out_key>
</options>

You should keep your PSPID, SHA1in_key and SHA1out_key in a safe place. You need all three when you do the iDeal configurations with your bank.

As for the arrangements with your bank, it is advised to start with the iDeal test environments. You can apply for a free iDeal test account with any iDeal bank from their websites. Register as the PSPID you have previously written down. There are manuals and documents you can read in the bank's iDeal testenvironment. The specific names of the manuals vary with each bank, but of particular interest are the back-office user manual and the basic integration manual. As the webshop administrator, you need to read the back-office user manual before proceeding.

Go to Configure > Technical Information > Data and origin verification and type in the SHA1in_key you previously entered in GO. This code will be sent to your bank with each payment request from the customer, to verify that the request is not tampered with really originates from your webshop.

Go to Configure > Technical Information > Transaction feedback, check "I want to receive transaction feedback parameters" and type in the SHA1out_key you previously entered in GO. The bank will send this code to you after each finalization of a payment request, to verify that the feedback is not tampered with and really originates from your bank. Your database won't be updated upon every transaction without this code.

In Configure > Technical Information > Transaction e-mails, you can configure whether and how you receive email feedback on transactions.

In Configure > Subscription (Abonnement in Dutch) > Administrative data, change the URL to your webshop's URL. This is what your customers will see every time, right after they have ended a transaction.

You are now good to go. You can make test transactions from your webshop or the demo webshop, as if you were a customer. After every transaction attempt, you receive an email and get changes in your billing module's Webshop Order table.