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!

 

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.

  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. 
 

2. 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" }

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

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 (MisterCash, 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, MisterCash, Sofort, credit cards en meer!