logo

Adding iDEAL (and other payment methods) to RSForm Pro

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!

For simple payment forms, try cciDEAL Simpel first!

If you are just building a simple payment form, try the new cciDEAL Simpel! It will save you complexity, money and time. It’s included in cciDEAL 5.0 at no extra cost! cciDEAL Simpel now supports adding multiple fields, and is really easy to use. Read more about cciDEAL Simpel Payment Forms.

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.

Page contents:

Install and enable the extensions

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

RSForm Pro configuration

  1. For Payments:
    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
  4. General:
    1. Open your RSForm Pro form
    2. Go to “Form Properties”
    3. At the right select “Form Info”
    4. Scroll down to “Submission”
    5. Make sure “Save Data To Database” is set to “Yes”

Form Properties > Emails

When a form is submitted, different e-mails can be sent directly after the form is submitted or only after a successful payment.

  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.

Form Properties > Form info > Thank You Message

After payment, you can redirect users to a cciDEAL page (configured in Components > cciDEAL > Communication settings > Messages after payment) or a RSForm Pro page (configured in Form Properties > Form info > Thank You Message). If you set “Show Thank You Message” to “Yes”, after the payment the users will be redirected to RSForm Pro. If you set “Show Thank You Message” to “No”, after the payment the users will be redirected to cciDEAL.

The benefit of redirecting to RSForm Pro, is that you can show the information filled into the form by the user in the Thank You Message with tags.

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.

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.

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 - Bancontact

If you want to add the popular Belgian payment method MisterCash/Bancontact, we 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)
  • Get the RSForm Pro – Bancontact plugin from the cciDEAL package
    • Download cciDEAL from your account
    • Unzip the package
    • Go to admin/plugins and find the plugin “rsformpro_mistercash”
  • Install it in Joomla! via Extensions > Extension Manager > Install
  • Go to Extensions > Extension Manager > Manage, search for “mister” and enable it
  • Go to RSForm Pro > Manage Forms and open your form
  • Find the new “Bancontact” option on the right under the form Components
  • Click and add it to your form, make sure the new Bancontact option is above the payment method dropdown
  • That’s it, you can now test if selecting “Bancontact” as a payment method will indeed redirect you to the Bancontact processing of your iDEAL account.

Now, we 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:

  • Get the RSForm Pro – Bancontact plugin from the cciDEAL package
    • Download cciDEAL from your account
    • Unzip the package
    • Go to admin/plugins and find the plugin “rsformpro_mistercash”
  • In all files, search and replace “mistercash” 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!

Extra: custom description RSForm Pro

If you use RSForm Pro and cciDEAL in combination with Mollie or TargetPay, you can add your own description to the payment. This description can be static (hidden field or non-customizable field in RSForm Pro) but also come from a field in RSForm Pro that your customer fills in themselves.
This description is in any case registered (as a field value) in RSForm Pro, in cciDEAL and forwarded to the aforementioned iDEAL accounts. Depending on the bank where your customer (the person who pays) is, the description may also be visible on the bank statement.You can think of a description such as “Donation by Jan-Willem” or “Payment invoice 1234”.

This has now only been implemented for Mollie or TargetPay because they have clearly indicated in their system how they deal with “custom descriptions”, and one of the cciDEAL customers specifically needed this. The other iDEAL subscriptions may also be able to do this, this is in the proces of being investigated by us. If you use these iDEAL accounts, you can get started right away with the steps below. We are not going to support this for ING Basic because it is expected that ING will stop offering this product in due course.If you use another iDEAL subscription, you can let us know your wish to do this by email at support@chillcreations.com.

Following steps:

  • Install the latest cciDEAL version over the current one via Extensions > Extension Manager > Install > Upload Package File
  • Go to Components > RSForm Pro > Manage forms > Open your (payment) form that needs to be sent to Mollie
  • Open/click the Edit button at the field of type Textbox where your visitors enter the description (or add a new field of type Textbox
  • “Name” must contain “ccideal_description” without quotes, cciDEAL recognizes that this is the desired description.
  • You may want to select “Alphanumeric” under the “Validations” tab under “Validation Rule”.
  • You may want to choose “30” under the “Attributes” tab under “Max Size”. Mollie does not state in their API how long a description may be, but the banks have their own limits. At 30 you are safe, 35 might still be possible. Test value “Invoice of order 123456789” is 27 characters (we’ve tested with
    that).
  • Now go ahead and test can test! Should work in one go!

Extra: changing order of payment methods

Actually, RSForm has no way to change the order of payment methods in the dropdown.Therefore, it is loaded based on the ID of the extension (plugin) in the Joomla database.So one way to adjust the order is to look up the plugins via the database in the table #__extensions and adjust the ID so that they are ascending as you want.Perhaps you could also uninstall both plugins (Payment from RSForm and  cciDEAL) and then reinstall, and then cciDEAL first, that might work too.