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 in cciDEAL 5.0

This manual is now updated for 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
Payment form examples
Customizing your iDEAL form
Overzicht van betalingen
FAQ: Alleen iDEAL, of ook andere betaalmethoden?

1. Enabling the required plugin

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

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

2. Payment form examples

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

Simple form with only an amount

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

Extended form with address details

{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

{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)

{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

{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

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

3. 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.

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

4. Overzicht van betalingen

Betalingen via cciDEAL Simpel worden allemaal volledig geregistreerd in cciDEAL. Het overzicht is te benaderen via Componenten > cciDEAL > Betalingen in het Joomla menu. Alle informatie die uw gebruikers invullen tijdens het afrekenen zal in dit overzicht zichtbaar worden, ook als de betaling niet voltooid is (u kunt dus zien welke betalingen mislukt zijn). Ook de status van de betaling is zichtbaar in het overzicht.

5. FAQ: Alleen iDEAL, of ook andere betaalmethoden?

Vraag: Werkt cciDEAL Simpel alleen voor iDEAL betalingen, of kan ik ook andere betaalmethoden (Bancontact, Sofort, credit cards) aanbieden via de betaal knop?

Antwoord: Je kunt meerdere betaalmethoden gebruiken met cciDEAL Simpel, maar of dat mogelijk is is afhankelijk van je iDEAL account/payment provider. Bijvoorbeeld Mollie heeft de betaalmethoden zo geïmplementeerd in hun systeem, dat als je er meerdere activeert in hun dashboard ze automatisch weergeven worden als iemand via jou Mollie account afrekent. Je kunt dan cciDEAL Simpel gebruiken voor eenvoudige betalingen in Joomla artikelen met iDEAL, Bancontact, Sofort, credit cards en meer!