VirtueMart configuration

Learn how to configure VirtueMart to accept payments via Mollie.

Create new order status

Mollie allows to release partially refund while VirtueMart doesn't have such order status by default. We need to create new status.

Go to VirtueMart > Configuration > Order Statuses.

Proceed to Order Statuses
Proceed to Order Statuses

Let's create a new status:

Create a new status
Create a new status

This is a Partially Refunded status:

Creating a Partially Refunded status
Creating a Partially Refunded status

Payment Method Information

In this tab select Mollie as a Payment Method.

Mollie payment method - Phoca Cart. General options
Mollie payment method - VirtueMart. Payment Method Information tab

Configuration

  • Sandbox ModeNo / Yes. If Sandbox Mode is enabled, no real money are transferred. Sandbox is used to test the payments.

  • DebugYes / No.

Mollie payment method options
Configuration tab. Order Statuses

Order Statuses

  • Payment Authorized — select the order status that will be applied based on authorized payment transaction result. By default it is Confirmed.

  • Payment Paid — select the order status that will be applied based on successful payment transaction result. By default it is Completed.

  • Payment Failed — select the order status that will be applied based on failed payment transaction result. By default it is Failed.

  • Payment Canceled — select the order status that will be applied based on canceled status of payment or order. By default it is Cancelled.

  • Payment Expired — select the order status that will be applied based on expired payment or order. By default it is Pending.

  • Payment Completed — select the order status that will be applied based on successful payment transaction result. By default it is Completed.

  • Payment Refunded — select the order status that will be applied based on refunded payment. By default it is Refunded.

  • Payment Partially Refunded — select the order status that will be applied based on partially refunded payment.

By default Payment Partially Refunded status is set to Refunded, but we advice to create Partially Refunded status manually (VirtueMart > Configuration > Order statuses > New) and after that go back to payment method options select the new created status here.

Mollie provides two models of APIs and there is a slight difference in available statuses for them.

Payments API does not use Completed status. See Payment status changes.

Orders API does not use Failed, Refunded and Partially Refunded statuses. See Order status changes.

Mollie options

Configuration tab. Mollie Options
Configuration tab. Mollie Options
  • Live API Key — set your Live API key

  • Test API Key — test your test API key

API keys are required fields to save the configuration. Fill them if even you are going to use sandbox mode.

  • Payment Description — the default value is VirtueMart: {ORDER_NR}, where {ORDER_NR} is the order number. This parameter is required to generate correct bank statement with necessary information about the order. The payment description on your customer's bank statement depends on the payment method they used for the transaction. For some payment methods, the description will show your organization's name and for others, it will show Mollie's name. Learn more. Note that this will work only for Payments API.

  • Send Order Items — this is an important parameter allowing to select which payment API should be used: Payments API or Orders API. If 'Send Order Items' parameter is set to 'Yes', then Mollie will work under Orders API and the cart items will be sent to Mollie. By default it is set to 'No' and Mollie works under Payments API.

  • Send Shipping Address — send customer's shipping address (required for some payment methods, for example Klarna).

  • Language — there are 20+ languages and regional localisations which are available to select. By default it is Auto-detect (tries to use user language set in Joomla).

  • Fee per Transaction — a fixed surcharge for using Mollie as a payment method.

  • Fee as Percent of Total Amount — a surcharge as a percent of the total amount for using Mollie as a payment method

  • Tax — surcharge tax to apply.

Last updated