Adding iDEAL and Other payment methods to Virtuemart

VirtueMart compatibility / Integration cciDEAL

VirtueMart 4.4.4 compatible on

• Joomla!5.5.2+
• Joomla!4.4.9
• PHP 8.3
• cciDEAL 7.0.4 and further releases
• cciDEAL integration for Virtuemart 4.4.4 is VM4 payment – cciDEAL integration
• Mollie V2
• Attention! – compatibility Virtuemart on Joomla!
  If you are still ( we do not recommend any though ) on VM3
  Note 1: Not advised VM3 on Joomla!4
  Note 2: VM3 + J3 or VM4 + J4 or J3 is advised!
  Note 3: VirtueMart 4, PHP 8 functions best on Joomla!4, we do not recommend VirtueMart3 on Joomla!4

Technical requirements

• cciDEAL 7.0.4 + , ccInvoices 5.0.3 + , ccNewsletter 4.0.1+
• J5 -> recommended PHP 8.3 & MYSQL 8.1
• J4 -> recommended PHP 8.2 & MYSQL 8.0
• Hikashop 5.1.2 compatible version with J4.4.9 + & J5.1+
• Virtuemart 4.4.4 compatible version with J4.4.9+ & J5.1+
• cciDEAL Integrations – For Virtuemart 4x is VM4 payment
• MollieV2

Important notice ! – As of cciDEAL 6.0.5 following changes were made for Joomla!4 & VirtueMart 4
For Virtuemart , cciDEAL integration is now VM4 Payment

cciDEAL Simpel!

For simple products, well do try cciDEAL Simpel!
If you are just selling a few simple products, try cciDEAL Simpel to create a simple payment form! It will save you complexity, money and time.
Read more about cciDEAL Simpel Payment Forms.
Dutch introduction video (This video is made by our founder David-Andrew for adding iDEAL to J!)
Important Notice : Since cciDEAL 6.0.5 changes were made for Joomla!4 & VirtueMart 4 cciDEAL Integrations – For Virtuemart 4x is VM4 payment. Rest of process will remain the same.
Since cciDEAL 7.0.4 – Technical requirements compatibility are to be met, for this please do consult changelog.

Dutch introduction video

Simple configuration

1. Use this manual to create a single payment method for iDEAL in Virtuemart. If this is your first time implementing iDEAL into Virtuemart, always start with the simple configuration.
2. First install Virtuemart in the Joomla! website and make sure it is configured correctly.
3. Then download the latest cciDEAL Platform version from our downloads section, and install it in Joomla!.
4. To install the plugin go to Components > cciDEAL Platform > Integrations, click “Install” next to your plugin and make sure it’s enabled under “Status”.
5. You will need to create and configure the iDEAL payment method in Virtuemart
   1. Go to Components > Virtuemart > Shop > Payment Methods and in the toolbar click “New”
   2. In the “Payment Method Information” tab
      1. In the “Payment Name” field enter “iDEAL”
      2. Set the “Published” radio button to “Yes”
      3. In the “Payment Description” field enter “iDEAL is een veilige betaalmethode waarmee u direct kunt afrekenen in internetbankieren van alle grote Nederlandse banken.”
      4. In dropdown “Payment Method” select “VM4 Payment – cciDEAL integration”
      5. In dropdown “Shopper Group” do not select any group unless you know what you are doing!
      6. In the “List Order” field enter “1” if you consider iDEAL your most important payment method
      7. In the toolbar, click “Save”
   3. Now open the “Configuration” tab
      1. Under the “Configuration” tab there might be a dropdown “Select payment method”. If you have multiple options here, have a look at the explanation at the “Extended configuration” section below. For now leave it unselected or select “All” or “iDEAL”.
      2. Change the “Order Status…” dropdowns to the values you require. Default values are:
         1. Pending = Pending
         2. Successful = Confirmed
         3. Failed = Cancelled (For Mollie = Authorized, Failed, Cancelled , Expired)
         4. Click “Save” in the top right toolbar to save all changes
6. A simple iDEAL payment method is now implemented in the Virtuemart shop

About One Page Checkouts
If you are using a One Page Checkout (OPC) extension with Virtuemart, please remember to always use the latest version of that OPC extension, with the latest version of Virtuemart and of course the latest version of cciDEAL. You might otherwise get issues with payments if you only update Virtuemart or cciDEAL and not the OPC extension.

 

Extended configuration

Some PSPs support multiple payment methods. For example:

• Mollie supports iDEAL and multiple payment methods
• All others, well we recommend Mollie

However:
If your PSP supports multiple payment methods and you have enabled those payment methods with your PSP, you can add them as separate payment methods in the Virtuemart checkout. They will all be processed via cciDEAL, but your customers will see them inside your shop as separate payment methods. Off course, this is very user friendly!
Setting this up is actually the same as the “Simple configuration” above, except for the extra step where you need to repeat the “Simple configuration” for every payment method you want to show in Virtuemart. So if you want to show iDEAL, and Bancontact, follow the “Simple configuration” three times, one time for every payment method. During the creation of the new payment methods enter the correct name in the “Name” field and select the correct payment method in the “Select payment method” dropdown under the “Configuration” tab.

Adding logos to payment methods

You can show the logos of the different payment methods you accept inside your checkout. We always advise doing this as it is user friendly and will increase the percentage of people that successfully place an order

Virtuemart, cciDEAL and e-mails

cciDEAL Platform follows the Virtuemart workflow for all mails.

Advanced iDEAL accounts
The mollie.com accounts are treated as “online” payment methods, like Paypal, by the banks, and they support automatic order status update in Virtuemart. cciDEAL Platform will send an e-mail depending on your settings in Components > Virtuemart > Configuration > Configuration > Checkout (at the bottom). You can set the Virtuemart order status to which a order should change when iDEAL is used as payment method in Components > Virtuemart > Shop > Payment methods > your iDEAL payment method > Configuration, and then the “Order status” dropdowns. cciDEAL will change the order status depending on the iDEAL payment status sent back to the website.
When a payment is cancelled, the customer is sent back to Virtuemart to choose another payment method. This is the same workflow as the default Paypal plugin.

Basic iDEAL accounts
Basic iDEAL accounts do not support the automatic order status update in Virtuemart. We can not change this, this is decided by the banks!

Therefore cciDEAL will change the order status immediately after the order is placed, depending on your settings in Components > Virtuemart > Shop > Payment methods > your iDEAL payment method > Configuration, and then the “Order status” dropdowns. An e-mail might be sent, depending on your settings in Components > Virtuemart > Configuration > Configuration > Checkout (at the bottom).
When a payment is failed, the customer is sent back to Virtuemart to choose another payment method.
After you configured your account and have done a payment, you can view the payment status in Components > Virtuemart > Orders & Shoppers > Orders. You can also view the payment status in the cciDEAL payment overview page.

Mollie account

• Go to the Mollie dashboard > Settings > Website profiles > Select the correct profile > Payment methods
• Enable Klarna as a payment method
• As soon as Mollie confirms that Klarna Pay is enabled for your account, continue with the setup in cciDEAL
  You need to enable just Klarna in your Mollie dashboard.
  When consumer selects this option, they will be redirected to the Klarna gateway, where it will be decided what Klarna payment methods (Later, Now , In 3 parts ) the consumer is entitled to based on several factors such as credit score, location, currency, etc.“ All on Klarna’s side.

https://www.mollie.com/nl/integrations/virtuemart

FAQ: You get this error
Error executing API call (422: Unprocessable Entity): The payment method is not enabled in your website profile. Field: payment.method.
Means The payment method used is not enabled in Mollie.)

Choose Other payment methods

Please do consult technical requirements on this page

• Klarna – Klarna ( Later, Now, In 3 parts ) Virtuemart
• IN3 Virtuemart
• Riverty Virtuemart
• Trustly Virtuemart
• Apple Pay Virtuemart

Klarna – Klarna (Later, Now, In 3 parts ) to Virtuemart with Mollie API

The latest test of our iDEAL integration was with Virtuemart 4.4.4 The fastest and easiest way to implement iDEAL is to use a Virtuemart version as close to the above as possible & cciDeal version 7.0.4 or higher.

To accept Klarna – Klarna (Later, Now, In 3 parts ) via Mollie API

Klarna

Klarna payment method has been updated for Virtuemart & Hikashop, when one method is used for all Klarna methods

Virtuemart cart selected payment or choose other payment, test profile test mode payment, Thank you page view your order for Klarna

Hikashop cart selected payment or choose other payment, test profile test mode payment,
Thank you page view your order for Klarna

Consult technical requirements on this page. Consult technical requirements on this page.

Consult your Klarna payment screens

Also see manual Adding Klarna – Klarna (Later, Now, In 3 Parts) to Virtuemart

cciDEAL configuration Klarna – Klarna (Later, Now, In 3 parts)

Use this manual page/ consult also your Mollie account
Consult technical requirements on this page
Configure cciDEAL
cciDEAL configuration

1. Make sure you are using cciDEAL 7.0.4 or higher where you want to use Klarna/ Virtuemart
2. Klarna payment method needs to be created & configurated in Virtuemart
3. Components > Virtuemart > Shop > Payment methods > Toolbar clicked New
4. Payment method info tab > Payment name field enter Klarna payment method > set to Yes
5. Payment description field > Enter Payment method
6. Payment method > Select VM4 Payment – cciDEAL integration
7. Shopper group > Note! If you know what you are doing by all means select, if not do not select
8. Toolbar clicked Save
9. Open configuration tab
10. If dropdown Select payment then find & select
11. Change order statuses to values you require
12. Click save top right for all changes saved
13. Klarna payment method enabled in Virtuemart

About order statuses

Orders that are Authorized and Paid at Mollie are “paid” in cciDEAL and the corresponding status in Virtuemart. It used to be that in order to ultimately receive your money, you must change the status of the order to Shipped in the Mollie dashboard, after you actually shipped the order. This is now legacy.

• Via Mollie API it is possible to send “Shipped” status back to a customer so customer receives an invoice.
• The status of the order can therefore automatically be change to confirmed when the payment has been authorized.
• FAQ: Can “Shipping status” be set in cciDEAL extension in the settings for when the order reaches that status, it returns the “Shipped” signal to Mollie so that the order is also completed in Mollie and the status is sent?

Yes!
Please do read further

Send Shipped status from VM to Mollie (Klarna ) cciDEAL & About order statuses in Klarna in cciDEAL with Mollie

The order status will now be automatically updated in Mollie with cciDEAL. ( as of cciDEAL version 6.0.9)
So after updating the order status to “Shipped” in VirtueMart, a request will now be send to Mollie to complete the order.
Klarna payment method sends shipping data to Mollie and cciDEAL works with Virtuemart shipping method.

Using custom database table to store data

ccideal works with VM Shipment.
Now, you intend to use a custom database table to store data for your shipping methods.
As of cciDEAL 6.0.9 the Paalz plug-in is added to the extension, if you chooses to use this above mentioned plugin to use a custom database table to store data.
https://www.paazl.com

“Tax per bill “support in Virtuemart

ccExtensions “Tax per bill “support in Virtuemart added support in Virtuemart condition, for the case when Virtuemart has the “Tax per bill ” option in the tax settings.
The Tax per bill option programmatically stores the tax amount in another part of the order array, so on the cciDEAL side it is processed and send to Mollie.

Consult technical requirements on this page

Why does Klarna refuse an order?

Klarna runs a risk: they pre-finance the payment. So they make a risk assessment based on the data that is available. This risk assessment is a trade secret, so you will not get to see why a payment has been rejected. You can only see that a payment has been rejected. You can only ask Klarna in general terms whether there is something structural.
It is so that when a consumer selects Klarna option, they will be redirected to the Klarna gateway, where it will be decided what Klarna payment methods (Later, Now , In 3 parts) the consumer is entitles to based on several factors such as credit score, location, currency, etc.“ All is on Klarna’s support side.

IN3 pay in 3 part

To allow customers to pay in 3 parts, with the Dutch payment method iDEAL with a settlement delay of 15 days after paying the first installment.
First term paid when they place their order, 30 days second installment after first payment, 60 days (no later than) final installment after the first payment , or pay remainder in full before installments.

Consult technical requirements on this page.

Virtuemart cart selected payment or choose other payment, test profile test mode payment, Thank you page view your order IN3 pay in 3 parts.

Riverty

To allow customers to pay afterwards with Riverty and is available throughout Europe.
Financial consumer risk are covered by Riverty as is taking care of reminder processes.
Riverty, formerly AfterPay, now European buy now pay later. Payment later in full.

Rates are to be found in your Mollie dashboard for The Netherlands, Belgium, Germany & Austria.

Consult technical requirements on this page.

Virtuemart cart selected payment or choose other payment, test profile test mode payment, Thank you page view your order for Riverty

Trustly

To allow consumers to pay online bin entering bank details at the checkout (an alternative for SOFORT, next to Klarna)

Rates are to be found in your Mollie dashboard for Austria, Germany, Denmark, Spain,
Estonia, Finland, United Kingdom, Lithuania , Latvia, Netherlands, Norway, Sweden.

Consult technical requirements on this page.

Virtuemart cart selected payment or choose other payment, test profile test mode payment, Thank you page view your order for Trustly

Apple Pay

To allow consumers to pay via Apple Pay ( for Apple users)
It’s about hiding it on the buyer’s side. It is to be checked if the Apple Pay method is available on the buyer’s device. Apple Pay is known for its fast, easy to pay and secured payments. System check if customers pays form an Apple Device.

Rates are to be found in your Mollie dashboard ( only credit cards and rates determined by card used) for Germany, Austria, Switzerland, Netherlands, Belgium, France, United Kingdom, Italy, Spain, Portugal, Sweden, Denmark, Finland, Poland and many more.
(Over 35 countries in all) (Apple Pay -> multicurrency)

Consult technical requirements on this page.

Virtuemart cart selected payment or choose other payment, test profile test mode payment, Thank you page view your order for Apple Pay

All Select Payment Virtuemart cart

Virtuemart cart : All Select payments methods to choose from are seen in select payment.
iDEAL , Klarna Later (deprecated) , Now (deprecated) , In3 parts , Klarna **( NEW) . IN3 Riverty Trustly , Apple Pay

Multicurrency

cciDEAL & ccInvoices uses the Mollie API version 2, which means it supports Mollie multicurrency. You can set up any supported currency in Virtuemart, HikaShop and it will automatically communicate all amounts with those currencies to Mollie.

Please use latest versions for up to date compatibility.

cciDEAL integration for ccInvoices

Payment methods from Mollie API (to be activated & verified in your Mollie settings)

Please use latest versions for up to date compatibility.