Plugin - iDeal (Create custom order forms)

The RSForm!Pro iDEAL Payment Integration Plugin allows you to add a new payment method to the existing Payment Package of RSForm!Pro - available services that you can use: Mollie, Sisow and TargetPay.

Download

You can download the plugin by logging with your purchase user, then head to Downloads > My Downloads > RSForm!Pro - view all plugins and modules > RSForm!Pro Files > Plugins > "iDEAL Plugin 3.1.0".

Install

In the backend area go to the Extensions > Manager > Install page, and install the plugin. Next thing is to publish the plugin from Extensions > Plug-in Manager, search for the "System - RSForm! Pro iDEAL Plugin" plugin and publish it.

Configuring the plugin

Configuring the iDEAL payment gateway can be done from Components > RSForm!Pro > Configuration > iDEAL tab:

• Enable Mollie Service: No / Yes
• Enable Sisow Service: No / Yes
• Enable TargetPay Service: No / Yes

iDEAL Mollie

• Mollie API Key: you can get this key from your Mollie account settings (more details).
• Cancel URL: Set the cancelling URL, global and submission related placeholders can be used as well.
• Show Only iDEAL Payment Methods: Yes / No. Set this to Yes to display only the iDEAL Payment Methods in the 'iDEAL Mollie Bank Issuer' field. Set to No if you would like to display all available Mollie methods for your account.
• Tax Type: Percent (%) / Fixed Rate
• Tax Value: Amount of tax. Total amount of the transaction must include this amount.

iDEAL Sisow

• Sisow Merchant Id: your Sisow Merchant Id.
• Sisow Merchant Key: your Sisow Merchant Key.
• Payment Mode: Test (Sandbox) / Live - Enable or disable Test Mode
• Tax Type: Percent (%) / Fixed Rate
• Tax Value: Amount of tax. Total amount of the transaction must include this amount.

iDEAL TargetPay

• TargetPay Layout Code: your TargetPay Layout Code.
• Payment Mode: Test (Sandbox) / Live - Enable or disable Test Mode
• Tax Type: Percent (%) / Fixed Rate
• Tax Value: Amount of tax. Total amount of the transaction must include this amount.

How to use the iDEAL plugin

After configuring the iDEAL parameters from Components > RSForm!Pro > Configuration > iDEAL tabs, there are some additional steps that needs to be taken in order the payment process to work properly:

Making sure the form is sent to the payment processor

The payment details will only be sent to the iDEAL payment processor if the user selects iDEAL from the "Choose Payment" field before submitting the form.

The "Choose Payment" field is used in order to allow the users to choose their payment method. It displays the payment methods added to the form in either a Dropdown or Radio Group. It can be shown on the form (allowing the user to select his preferred payment method) or not (forcing the user to pay using the default payment method).

In order for the iDEAL payment methods to be available within the Choose payment field, the following payment related elements have to be part of your form.

• for Mollie:
  • (Payment) iDEAL Mollie - actual payment related element that will be included within the Choose Payment selection on your form.
  • (Dropdown) iDEAL Mollie Issuer Bank - a dropdown that allows selecting which bank to use.
 
• for Sisow:
  • (Payment) iDEAL Sisow - actual payment related element that will be included within the Choose Payment selection on your form.
  • (Dropdown) iDEAL Sisow Mollie Issuer Bank - a dropdown that allows selecting which bank to use.
 
• for TargetPay:
  • (Payment) iDEAL TargetPay - actual payment related element that will be included within the Choose Payment selection on your form.
  • (Dropdown) iDEAL TargetPay Mollie Issuer Bank - a dropdown that allows selecting which bank to use.

Adding costs

In order to receive funds using RSForm!Pro and iDEAL payment plugin, your form needs to include a cost. In order to add costs to your form you can use any of the following fields:

• Single Product - Adds a single product to the form. For this type of field you can set up a caption, description and a price.
• Multiple Products - Adds the ability to display multiple products to be purchased either in a Dropdown or a Checkbox. Its items need to be specified in the following manner: price | label (ex: 15 | T-shirt)
• Quantity - Allows the user to choose the amount of products (simple or multiple).
• Donation - Allows the user to type in the amount to be paid inside a standard Textbox.
• Total - This field is used alongside the Donation, Single and Multiple Products fields. It calculates the total price to be paid.

Modifying iDEAL vars through Scripts called after form has been processed

This process is similar to the already existing example regarding the PayPal parameters control. First you will need to get a new instance of the iDEAL object, which is done with:

For Mollie:

    $mollie = RSFormProMollie::getInstance();

    //then you can override parameters as in this example:

    $mollie->args['description'] = 'This is a new description.';

For Sisow:

    $sisow = RSFormProSisow::getInstance();

    //then you can override parameters as in this example:

    $sisow->args['description'] = 'This is a new description.';

For TargetPay:

    $targetpay = RSFormProTargetPay::getInstance();

    //then you can override parameters as in this example:

    $targetpay->args['description'] = 'This is a new description.';