logo

Adding iDEAL (and other payment methods) to Joomla! articles – cciDEAL Simpel

It is possible to accept iDEAL (and other payment methods) payments from within Joomla! articles with great flexibility and ease! You can, for example, accept donations or get payments for an invoice or order. cciDEAL Simpel doesn’t just support iDEAL, it also supports other payment methods that your payment provider offers.

cciDEAL Simpel supports popular payment methods!

mollie betaalmethoden

The amount to be paid and payment ID can be fixed (set by you) or kept “open” so the user can enter his/her preferred value. But it is also possible to use a dropdown from which the user can select an amount to be paid. To add an iDEAL form to any Joomla! article, a simple “tag” is added to the article.

That tag will be converted to a nice looking iDEAL form in your website. The below image shows what this iDEAL button might look like in your Joomla! articles:

iDEAL in Joomla! articles

New since cciDEAL 5.0+

This manual is now updated as of cciDEAL 5+, so if you are adding new forms, make sure you install that first!

  • You can now add unlimited form fields
  • All forms are now fully responsive
  • Form title is now also stored with the payment details in cciDEAL > Payments
  • Shortcode can now also use {ccideal } but old shortcodes with {ccidealplatform } will keep working
  • It’s no longer needed to use underscore’s for spaces in text, just use spaces 🙂

 

Want to start playing with examples? Scroll to the bottom for examples that you can copy/paste right into your articles!

 

Enabling the required plugin

To easily work with iDEAL in your Joomla! articles, you need to enable two plugins that where installed with cciDEAL.

  1. First make sure you already installed the latest version of cciDEAL
  2. Go to Components > cciDEAL > Integrations, click “Install” next to “Content plugin” and make sure it’s enabled under “Status”.
  3. Now you can go to the Joomla! article manager and use the below manuals to add iDEAL forms to your articles.

Payment form examples

You can copy/paste these examples to your article, they should immediately work!

Simple form with only an amount

ideal site article example-05

{ccideal width="80%" amount="15"}

Extended form with address details

ccideal simpel extended form

{ccideal title="Eenvoudig betalen" amount_by_user amount="15.00,22.00" amount_text="Kies bedrag:" extra_textfield[]="Voornaam" extra_textfield_required[]="Achternaam" extra_textfield_required[]="Straatnaam" extra_textfield_required[]="Plaats" extra_textfield_required[]="Postcode" extra_textarea[]="Opmerking" submit_button="Verder" }

Form with multiple amounts in dropdown and fixed payment ID

ideal_site_article_example-01

{ccideal title="Eenvoudig betalen" width="80%" amount="15.00,22.00" amount_text="Kies bedrag:" paymentid="399" paymentid_text="Kenmerk:" submit_button="Verder" }

Form with fixed amount and open payment ID (for invoice numbers)

ideal_site_article_example-02

{ccideal title="Eenvoudig betalen" width="80%" amount="15.00" amount_text="Bedrag:" paymentid_by_user paymentid_text="Uw factuur:" submit_button="Verder" }

Form with open amount

ideal_site_article_example-03

{ccideal title="Eenvoudig betalen" width="80%" style="background-color: transparent;">amount_by_user amount_text="Uw donatie:" submit_button="Verder" }

Form with fixed amount and payment ID

ideal_site_article_example-04

{ccideal title="Eenvoudig betalen" width="80%" amount="15.00" amount_text="Kies bedrag:" paymentid="399" paymentid_text="Kenmerk:" submit_button="Verder" }

Customizing your iDEAL form

The above code has to be customized to your wishes before it is usable. All possibilities are explained in below table and image.
ideal_site_article_notes

 

Type Possible values
title Title above the form, “Eenvoudig betalen” by default
width You can change the form width in your custom CSS file or by adding a width option to the form. The width option is not required.
amount There are three options for the amount shown in the form

  • A fixed single amount can be created by adding: amount=”15.00″
  • Multiple fixed amounts in a dropdown can be created by: amount=”15.00,22.00″
  • An input field so a user can enter an amount can be created by: amount_by_user
amount_text The title of the amount field, “Kies bedrag:” by default
paymentid There are a few different options for the payment ID in the form

  • To set a fixed payment ID, use the code: paymentid=”399″
  • To allow the user to enter a payment ID himself, add the code: paymentid_by_user
  • If you do not set a preferred payment ID tag, cciDEAL will automatically add a randomly generated one.

This value can be removed from the tag if you don’t want to show a payment ID.

paymentid_text The title of the payment id, “Kenmerk:” by default. This value can be removed from the tag if you don’t want to show a payment ID.
extra_textfield[]=”Field name” This can be used to collect more information about the user or payment in a field. These fields can be used to collect, for example names, e-mail addresses etc. You can add as many fields as you like. The field name can be set by changing “Field name”, for example: extra_textfield[]=”First name” or extra_textfield[]=”Last name”

  • for an optional text field use extra_textfield[]=”Field name” in your form
  • for a required text field use extra_textfield_required[]=”Field name” in your form

The field will change nothing about the iDEAL payment, it will only register the information submitted by the user, and show it in the “Extra information” field in the cciDEAL > Payments page. These fields will accept letters, numbers, spaces and . , ? ! @ #. Maximum input 100 characters. Other symbols are blocked for security reasons. 

extra_textarea[]=”Field name”  This can be used to collect more information about the user or payment with a text area. The text area can be used to collect short messages.  You can add as many text area’s as you like. The field name can be set by changing “Field name”, for example: extra_textarea[]=”Order notes” or extra_textarea[]=”Opmerkingen”

  • optional text area use extra_textarea[]=”Field name” in your form
  • required text area use extra_textarea_required[]=”Field name” in your form

The text area will change nothing about the iDEAL payment, it will only register the information submitted by the user, and show it in the “Extra information” field in the cciDEAL Platform Payments page. These fields will accept letters, numbers, spaces and . , ? ! @ #. Other symbols are blocked for security reasons.

submit_button Text of the submit button, “Verder” by default

Payment overview

Payments via cciDEAL Simpel are all fully registered in cciDEAL. The overview can be accessed via Componenten > cciDEAL > Betalingen in the Joomla menu. All information that your users enter during the checkout will be visible in this overview, even if the payment has not been completed (so you can see which payments have failed). The status of the payment is also visible in the overview.

FAQ: Only iDEAL, or also other payment methods?

Question: Does cciDEAL Simple only work for iDEAL payments, or can youalso offer other payment methods (Bancontact, Sofort, credit cards) via thepayment button?

Answer: You can use multiple payment methods with cciDEAL Simple, but whether that is possible depends on your iDEAL account/payment provider. For example, Mollie has implemented the payment methods in their system in such a way that if you activate several in their dashboard, they are automatically displayed when someone pays through your Mollie account. You can then use cciDEAL Simple for easy payments in Joomla articles with iDEAL, Bancontact, Sofort, credit cards and more!