You can add iDEAL as a payment method to forms in RSForm! Pro. This allows you to setup a form with iDEAL payment in no time! This can be used for a small webshop, donations, down-loadable products and more, with the mostly popular payment method in the Netherlands!

Please read the official RSForm! Pro Payment Plugin manual, and then read this manual. The RSForm! Pro iDEAL plugin works exactly as the RSForm Pro Paypal plugin, so the RSJoomla! manual also applies to iDEAL. 

1. Install and enable the extensions

  1. Download and install RSForm Pro in the Joomla! website. 
  2. Download the latest cciDEAL Platform version from our downloads section, and install it in Joomla!.
  3. To install the plugin go to Components > cciDEAL Platform > Integrations, click "Install" next to your plugin and make sure it's enabled under "Status". 
  4. Go to Extensions > Plugin Manager, and use the filter to search for "RSForm".
  5. In the results, enable all other payment plugins: System - RSForm! Pro Paypal, System - RSForm! Pro Payment, System - RSForm! Pro Offline Payment.

2. RSForm Pro configuration

  1. Go to Components > RSForm! Pro > Configuration
  2. Check the tabs "Payment", "Paypal" and "iDEAL" one by one
  3. Enter the details that apply to you

3. Form e-mail settings

When a form is submitted, different e-mails can be sent directly after the form is submitted or only after a successful payment. 
To configure this, follow the steps below.

  1. Go to your form at Components > RSForm! Pro > Manage Forms > Your form
  2. In the form, go to the "Properties" tab
  3. In the "Emails" section, open pages "User Emails", "Admin Emails" and "Additional Emails" and set the details that apply to you
  4. Scroll down to the "Extras" section, open page "Payment Email Settings" and change the settings if required. 

4. Adding product or donation fields to the form

  1. Go to your form at Components > RSForm! Pro > Manage Forms > Your form
  2. Make sure you are in the "Components" tab
  3. In the bottom left, you will now notice the "payment" fields that can be added to your form.

You can add a single product, multiple products or donation field to the form. You can not add multiple different "payment" field types (for example: two single products field and one donation field) in one form, so choose one.

The "Multiple products" field needs a little more explanation. To add a "Multiple products" field, click on it and then:

  1. Add your preferred details in the Name, Caption and Description fields
  2. In the items field, you can add every product option in this syntax: Product price|Product name. Example of three products:
    10|Product one
    20|Product two
    30|Product three
  3. Under Attributes set whether a user can select multiple products (Multiple? Yes) and View Type (Dropdown or Checkbox)
  4. After your selection is made, click Save.
  5. You can add another Multiple Products field (for other products) or continue. 

5. Adding payment method fields to the form

  1. After you added product fields, click on the Total field and add it directly under the product fields. 
  2. Now, configure your payment method(s). RSJoomla! has hard coded support for Paypal into RSForm Pro, so the below steps are required!
  3. Add the "Choose Payment" field first
  4. You must always add the "(Payment) Paypal" payment method field, if you do not want to offer Paypal as a payment method, unpublish it
  5. Now add the "(Payment) iDEAL" payment method field
  6. Add a "Submit Button" field and your form is ready!
  7. Click "Preview" in the toolbar and give it a try!  

Be sure to test that the form is registered correctly under Components > RSForm Pro > Manage Submissions. also test that the e-mails are sent according to your settings as mentioned under the above "Form e-mail settings" chapter. 

After you configured your bank/PSP account and have done a payment, you can view the payment status in Components > RSForm Pro > Manage Submissions. Select your form under "View submissions for". The iDEAL status will be shown in the Paypal status column. You can also view the payment status in the cciDEAL Platform payment overview page. 

6. Extra: adding more separate payment methods

This section only applies to iDEAL accounts that support multiple payment methods like Rabo OmniKassa, Mollie etc. RSForm Pro does not have a method to create multiple payment methods from a single RSForm Pro payment plugin. So the default cciDEAL integration plugin for RSForm Pro will automatically try to show all payment methods that an iDEAL account (like Mollie) supports.  

RSForm Pro - MisterCash

If you want to add the popular Belgian payment method MisterCash or Belfius, I have a small plugin that can be installed to achieve that. This video explains the below steps. 

  • Update to at least cciDEAL 4.4.5 (Downloads, Update instructions)
  • Download the RSForm Pro - MisterCash plugin or RSForm Pro - Belfius plugin
  • Install it in Joomla! via Extensions > Extension Manager > Install
  • Go to Extensions > Extension Manager > Manage, search for "mister" or "belfius" and enable it
  • Go to RSForm Pro > Manage Forms and open your form
  • Find the new "MisterCash" or "Belfius" option on the right under the form Components
  • Click and add it to your form, make sure the new MisterCash/Belfius option is above the payment method dropdown
  • That's it, you can now test if selecting "MisterCash" or "Belfius" as a payment method will indeed redirect you to the MisterCash/Belfius processing of your iDEAL account. 

Now, I can imagine you would like the default iDEAL payment method to redirect directly to iDEAL and not all payment methods of the iDEAL account. 

  • Go to /plugins/system/rsfp_ideal/rsfp_ideal.php
  • Around line 124, find the code: 
    <input type="hidden" name="ideal_paymentmethod" id="ideal_paymentmethod" value="ALL"/>
  • Change "ALL" to "ideal"
  • If you want to make sure this plugin is not overwritten when cciDEAL has an update, you can duplicate and rename the plugin (see the steps to do this below). But you should only do this if you have basic experience in PHP and Joomla! development. 

If you need more payment methods to be separate options in the RSForm Pro dropdown:

  • Download the RSForm Pro - Belfius plugin 
  • In all 3 files, search and replace "belfius" with the payment method you want to use (one word, no spaces or special characters etc).
  • Search and replace "720" with "730".
  • Zip the plugin and install it in Joomla.
  • Go to Extensions Manager > Manage > Search for "System - RSFormPro - cciDEAL"
  • Enable your new plugin, you should now see it in RSForm Pro fields!

7. Extra: custom description RSForm Pro

Als je RSForm Pro en cciDEAL gebruikt in combinatie met Mollie, TargetPay of Rabo OmniKassa kun je een eigen beschrijving meegeven aan de betaling. Deze beschrijving kan statisch (verstopt veld of niet-aanpasbaar veld in RSForm Pro) zijn maar ook komen uit een veld in RSForm Pro dat jou klant zelf invult. Deze beschrijving wordt in ieder geval geregistreerd (als veld waarde) in RSForm Pro, in cciDEAL en doorgestuurd naar eerder genoemde iDEAL accounts. Afhankelijk van de bank waar jou klant (diegene die afrekent) bij zit kan de beschrijving ook zichtbaar zijn op het bank afschrift. Je kunt dan denken aan een beschrijving zoals "Donatie door Jan-Willem" of "Betaling factuur 1234". 

Dit is nu alleen voor Mollie, TargetPay en Rabo OmniKassa geïmplementeerd omdat ze in hun systeem duidelijk heeft aangegeven hoe ze met "custom descriptions" omgaan, en een van de cciDEAL klanten dit specifiek nodig had. De andere iDEAL abonnementen kunnen dit wellicht ook, dat heb ik tot nu niet onderzocht. Als je deze iDEAL accounts gebruikt kun je met de onderstaande stappen direct aan de slag. Ik ga dit niet ondersteunen voor ING Basic omdat de verwachting is dat de ING dit product op termijn zal stoppen aan te bieden. Als je een ander iDEAL abonnement gebruikt kun je je wens om dit ook te kunnen doen aan mij kenbaar maken per mail op .

De stappen:

  • Installeer de laatste cciDEAL versie over de huidige via Extensions > Extension Manager > Install > Upload Package File
  • Voor de zekerheid: verwijder de bestaande RSForm Pro plugin via Extensions > Extension Manager > zoek op "ideal" en verwijder "System - RSFormPro - cciDEAL Platform"
  • Installeer de geupdate plugin via Components > cciDEAL > Integrations > RSForm Pro > Install
  • Ga naar Components > RSForm Pro > Manage forms > Open je (betaal) formulier die naar Mollie moet
  • Open/klik de Edit knop bij het veld van type Textbox waar jou bezoekers de omschrijving invoeren (of voeg een nieuw veld toe van type Textbox)
  • In "Name" moet staan "ccideal_description" zonder aanhalingstekens, daaraan herkent cciDEAL dat dat de gewenste omschrijving is.
  • Je wilt misschien onder tabblad "Validations" bij "Validation Rule" kiezen voor "Alphanumeric"
  • Je wilt misschien onder tabblad "Attributes" bij "Max Size" kiezen voor "30". Mollie heeft in hun API niet staan hoe lang een description mag zijn, maar de banken hebben hun eigen limieten. Met 30 ben je veilig, 35 zou misschien ook nog kunnen. Test waarde "Factuur van order 123456789" is 27 characters (daarmee heb ik getest).
  • Nu kun je testen! Zou in een keer moeten werken!

8. Extra: changing order of payment methods

Eigenlijk heeft RSForm geen manier om de volgorde van betaal methoden in de dropdown aan te passen. Daarom wordt het geladen op basis van de ID van de extensie (plugin) in de database van Joomla. Dus een manier om de volgorde toch aan te passen is via de database in de tabel #__extensions de plugins opzoeken en de ID aanpassen zodat die oplopend zijn zoals je wilt. Wellicht kun je ook de beide plugins verwijderen (Payment van RSForm en cciDEAL) en dan opnieuw installeren, en dan cciDEAL eerst, dat zou ook kunnen werken.