Plugin - iDeal (Create custom order forms)

RSForm!Pro iDEAL Payment Plugin

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.

Please note that this plugin is commercial, it needs to be purchased separately. Also you will have to make sure that you install the Payment Package plugin first.
 
Downloading and Installing the plugin
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 for Joomla! 3.x".

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 "RSForm! Pro - iDEAL" 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

For each service you enable, after you Save your selections, a new tab for each service will then appear for further configuration as follows.

 
iDEAL Mollie
  • Mollie API Key: you can get this key from your Mollie account settings (more details).
  • 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.
Important:
  • When testing TargetPay (sandbox mode) ensure that your grand total (including tax) is not higher than 1, otherwise it won't work.
 
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).

If you are using a single payment method and you need to hide the Choose payment field, this can be achieved by editing the field and setting to "No" the "Show in front-end?" option within the "Attributes" tab.

In order 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.

When using Sisow, the "Issuer Bank" element is required in your form. Other Issuer Bank elements are optional and the user would select the bank from the payment gateway if you don't add it.

 
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)
  • 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.';
 

The above examples will change the description sent to the payment processor, for a more detailed list of parameters available in the API you can check the developer documentation:


3 persons found this article helpful.


Was this article helpful?

Yes No
Sorry about that