> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/mollie-for-virtuemart/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/mollie-for-virtuemart/virtuemart-configuration.md).

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

<figure><picture><source srcset="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FlAzhdvbJrRUQxQaadavI%2Fpartially-refunded1-1-dark.png?alt=media&amp;token=554a77ea-a980-46bb-be85-485c1518568c" media="(prefers-color-scheme: dark)"><img src="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FJ4TkXWVORL5Oy8r2OCDs%2Fpartially-refunded1-1.png?alt=media&amp;token=cc0a3f16-b283-4f44-9ab9-00e7f0761799" alt="Proceed to Order Statuses"></picture><figcaption><p>Proceed to Order Statuses</p></figcaption></figure>

Let's create a new status:

<figure><picture><source srcset="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FeDo9MF0yMa6YtbsouQZk%2Fpartially-refunded2-1-dark.png?alt=media&amp;token=01dd9792-8493-47b3-9feb-50ee16875ffa" media="(prefers-color-scheme: dark)"><img src="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FY10lHFIUQHSoEPm6VSso%2Fpartially-refunded2-1.png?alt=media&amp;token=038f69cd-c73a-4da2-8e27-cf6315137013" alt="Create a new status"></picture><figcaption><p>Create a new status</p></figcaption></figure>

This is a Partially Refunded status:

<figure><picture><source srcset="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FIg3NEHDcHGpkvDP8Z3yR%2Fpartially-refunded3-1-dark.png?alt=media&amp;token=1dc6e0a7-ebed-4974-bcdb-253dcc9a1916" media="(prefers-color-scheme: dark)"><img src="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2F3BGCM8XUCoRtoufeyuRo%2Fpartially-refunded3-1.png?alt=media&amp;token=eb9bb922-9858-4a70-94cc-33df44070b84" alt="Creating a Partially Refunded status"></picture><figcaption><p>Creating a Partially Refunded status</p></figcaption></figure>

### Payment Method Information

In this tab select Mollie as a `Payment Method`.

<figure><picture><source srcset="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FUKB71FPuuOSGHAX4TVlZ%2Fvm-mollie2-dark-min.png?alt=media&amp;token=bf7c4c07-72c9-43eb-ba45-a76cd62e0049" media="(prefers-color-scheme: dark)"><img src="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FHOd2wHzhuREmVON1ARDt%2Fvm-mollie1-min.png?alt=media&amp;token=6d0e3277-9fc7-4119-9843-46b75b89ed5f" alt="Mollie payment method - VirtueMart. General options"></picture><figcaption><p>Mollie payment method - VirtueMart. Payment Method Information tab</p></figcaption></figure>

### Configuration

* **Sandbox Mode** — *No* / *Yes*.\
  If Sandbox Mode is enabled, no real money are transferred. Sandbox is used to test the payments.
* **Debug** — *Yes* / *No*.

<figure><picture><source srcset="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FzoPSE8BLmbfJ4bBJET1V%2Fvm-mollie2-dark.png?alt=media&amp;token=a788c9fd-3083-49fc-8a28-0a805b4be188" media="(prefers-color-scheme: dark)"><img src="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2Fg3Rr0OLNMy8p5O8z0aWw%2Fvm-mollie2.png?alt=media&amp;token=112a263f-2fe6-4942-b33c-4d834590fec6" alt="Mollie payment method options"></picture><figcaption><p>Configuration tab. Order Statuses</p></figcaption></figure>

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

{% hint style="info" %}
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.
{% endhint %}

#### Mollie options

<figure><img src="https://1115340039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq8FVZ6XffRmwjTldm5Zc%2Fuploads%2FtgmJnskjs3X6VMoqdmnw%2Fvm-mollie3-min.png?alt=media&amp;token=16ae70e7-76f7-412d-9ab6-bb62b0f139a6" alt="Configuration tab. Mollie Options"><figcaption><p>Configuration tab. Mollie Options</p></figcaption></figure>

{% hint style="success" %}
You can find options under Settings in your `Mollie Account Panel` > **More** > **Developers** > **API keys**. See this article.
{% endhint %}

* **Live API Key** — set your Live API key
* **Test API Key** — set your Test API key

{% hint style="info" %}
API keys are required fields to save the configuration. Fill them if even you are going to use sandbox mode.
{% endhint %}

* **Payment Description** — the default value is `VirtueMart: {ORDER_NR}`, where `{ORDER_NR}` is the order number. This parameter is used to generate the bank statement description with necessary information about the order. Note that this field is displayed only when **Send Order Items** is set to *No*. [Learn more](https://help.mollie.com/hc/en-gb/articles/360005449393-What-will-my-customer-see-on-their-bank-statement).
* **Send Order Items** — send order items as line items of the order (required for payment methods such as Klarna or vouchers). Note: customer billing address is always transmitted automatically by the plugin.

{% hint style="warning" %}
**Some payment methods require order line items.** Enable '**Send Order Items**' (and '**Send Shipping Address**' if applicable) to ensure methods like Klarna Pay later or vouchers appear on the Mollie checkout.
{% endhint %}

* **Send Shipping Address** — send customer's shipping address (optional or required depending on the payment method, e.g. 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.
