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!
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:
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 :)
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
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

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
|
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
|
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"
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"
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!