Configuration for Mollie

This chapter explains what needs to be done to activate a Mollie account in combination with cciDEAL. The below steps only need to be done once per website and once per Mollie account. 

Check your Mollie account

Accepting payments via Mollie in your Joomla! site will not work if the Mollie account is not activated correctly or completely. To save your own and our time, please make sure the Mollie account is active before you continue. 

1. Go to mollie.com
2. Login with the correct account you want to use with cciDEAL
3. Complete any steps that you still have to do for Mollie (uploading identification, accepting terms and conditions etc)
4. In the left menu under “Settings”, select Website profiles > Payment methods
5. Make sure you have enabled one or multiple payment methods and Mollie has verified them
6. Only if everything is enabled and ready, continue to the next step
7. You do not need to set a webhook URL or any other URL in your Mollie account, cciDEAL sends these to Mollie automatically. 

Configuring cciDEAL

Mollie.com has a new API, and the below steps explain how to implement that in cciDEAL. If you are updating from an older cciDEAL version (before 4.x) you will also need to follow these steps to implement the new API.

1. Go to the administrator of the Joomla! website
2. Once you are logged in, go to Components > cciDEAL > Configuration
3. You now see the configuration of cciDEAL
4. Start entering your preferred settings. You can hover over the text to get an explanation of each setting.
   1. Note that the Mollie Partner ID is NOT the API key.
   2. You need the Mollie API Keys. Follow these steps to find them.
   3. Log into the Mollie website and go to Developers > API keys.
   4. Click “Copy” behind the API key of the website profile that belongs to your website.
   5. Select the “Live API Key” and copy that to the “Live API key” field in cciDEAL
   6. Select the “Test API Key” and copy that to the “Test API key” field in cciDEAL
5. Set “Account status” to “Test”
6. When the configuration is completed, click “Save”
7. You do not need to set a webhook URL or any other URL in your Mollie account, cciDEAL sends these to Mollie automatically. 

Complete a test payment

Perform two test payments, one with status “Paid” and one with status “Cancelled”, by following the below steps. 

1. Go to the Joomla! website, and the location where iDEAL payments can be made
2. Start making a payment, which will be cancelled, and in test mode payments page (after selecting a payment method), select “Canceled”. Make sure, when you return to the website, you get a warning explaining the payment failed. Also go to the administrator, then Component > cciDEAL > Payments and make sure the latest payment has status “Cancelled”. 
3. Start making the payment, which will be successful, and in test mode payments page (after selecting a payment method), select “Paid”. Make sure, when you return to the website, you get a notification explaining the payment was successful. Also go to the administrator, then Component > cciDEAL > Payments and make sure the latest payment has status “Paid”.

Complete a real payment

To make 100% everything is setup correctly, try to make a real payment in the website. 

1. Set cciDEAL Platform to production
   1. Go to the administrator of the Joomla! website
   2. Once you are logged in, go to Components > cciDEAL > Configuration
   3. Set “Account status” to “Production”
2. Perform a real payment, which will be successful. Make sure, when you return to the website, you get a notification explaining the payment was successful. Also go to the administrator, then Component > cciDEAL > Payments and make sure the latest payment has status “Paid”.

Multicurrency

cciDEAL uses the Mollie API version 2, which means it supports Mollie multicurrency. You can set up any supported currency in Virtuemart, HikaShop and ccInvoices, and cciDEAL will automatically communicate all amounts with those currencies to Mollie. If you use ccInvoices, at least ccInvoices 3.0 is required to work with multicurrency via Mollie.