> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mollie

> Access Mollie payments, customers, and refunds to monitor and operate payment flows

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `MOLLIE_API_KEY` is sent as the `Bearer` prefixed `Authorization` header.
* **Docs**: [https://docs.mollie.com/reference/authentication](https://docs.mollie.com/reference/authentication)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable         | Required | Description                                                                                                                          |
| ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `MOLLIE_API_KEY` | Yes      | Mollie API key (starts with live\_ for production or test\_ for test mode) [Docs](https://docs.mollie.com/reference/authentication). |

## Setup

1. **Create a Mollie account**: Sign up at [https://www.mollie.com](https://www.mollie.com). You can use test mode immediately after signup, before your account is fully activated for live payments.
2. **Get your API key**: In the Mollie Dashboard, go to Developers > API keys. Each website profile has a paired test key (test\_...) and live key (live\_...). Copy the key right away; treat it as a secret.
3. **Configure the environment variable**: Set MOLLIE\_API\_KEY to your test\_ key while developing. Payments made with a test\_ key are simulated and never charge real money. Switch to your live\_ key once your account is approved for live payments.

* Test mode and live mode are selected by the key prefix: test\_ keys hit the same [https://api.mollie.com/v2](https://api.mollie.com/v2) endpoints but operate on simulated data.
* Amounts are strings with the exact number of decimals for the currency, e.g. "10.00" for EUR.
* Set a webhookUrl on payments in production so you receive status changes; polling get\_payment also works for agent workflows.

Provider API reference: [https://docs.mollie.com/reference](https://docs.mollie.com/reference)

## Tools

| Tool                 | Access | Description                                                                                            |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------ |
| List Payments        | Read   | List Mollie payments in reverse chronological order to review recent transactions                      |
| Get Payment          | Read   | Retrieve a single Mollie payment with its current status and details                                   |
| Create Payment       | Write  | Create a Mollie payment and get a checkout URL to send to the customer                                 |
| List Customers       | Read   | List Mollie customers to find customer IDs for payments or refund context                              |
| List Payment Methods | Read   | List the payment methods enabled on your Mollie profile, e.g. to pick a valid method for a new payment |
| Create Payment Link  | Write  | Create a shareable hosted payment link the customer can open to pay, without building a checkout       |
| List Payment Refunds | Read   | List the refunds created for a payment to review refund status and history                             |
| Create Refund        | Write  | Refund all or part of a Mollie payment back to the customer                                            |

## Example prompts

* List my most recent Mollie payments and summarize their statuses and amounts.
* Look up a Mollie payment by ID and tell me its current status, amount, and method.
* Refund a Mollie payment: confirm the payment details with me first, then create the refund.