- Create payments for the amount of an order and send customers to Mollie’s hosted checkout
- Offer the payment methods enabled on your Mollie profile, such as iDEAL, Bancontact, and cards
- Mark an order as paid only after Mollie confirms the payment
- Retry a failed request without charging a customer twice
- List recent payments and their status
Common use cases and example apps
These examples show what you can build with Mollie, each with a prompt to start from.How to connect Mollie
Who can create Mollie connections depends on your plan and workspace settings. App + chat connectors are available by default. On Business and Enterprise plans, Who can create connections and clients starts at Admins. Some Enterprise workspaces start at No one, which disables the connector. An admin or owner changes it in Connectors → Admin settings → App + chat connectors. You can create multiple Mollie connections using different API keys, which is useful for separating test and live payments or connecting different Mollie profiles. When the connection is created, you can link it to the projects where you want to use it. Anyone building in a project can ask Lovable in chat to link their project to it.Prerequisites
Before connecting Mollie, make sure you have:- A Mollie account with at least one payment method enabled on your website profile
- A Mollie API key for that profile
- Permission to create connections in your Lovable workspace (see Who can create connections and clients)
Payments made through this connector go to your Mollie account. Mollie charges its transaction fees directly, and billing is handled by Mollie, not Lovable.
Step 1: Get a Mollie API key
A Mollie API key lets your Lovable app create and read payments for one Mollie website profile. Each profile has a test key, which starts withtest_, and a live key, which starts with live_. Payments made with a test key are simulated, so use the test key while you build and switch to the live key when you’re ready to take real payments.
To get a Mollie API key:
1
Open your Mollie Dashboard
Sign in to the Mollie Dashboard.
2
Open API keys
Go to Developers → API keys. If your account has more than one website profile, select the profile you want to take payments with.
3
Copy the key
Copy the test key or the live key and store it securely. Live payments work only after Mollie has activated your account.
Step 2: Connect Mollie to Lovable
Use your test key for the first connection, so you can try payments without moving real money.1
Open Mollie in Connectors
Open Connectors and select Mollie. For the other places to open the catalog from, see Where to find connectors.
2
Add a connection
Click Connect on the connector page. The form is split into collapsible sections, Details, Configure connection, and Sharing.
3
Name the connection
Under Details, Lovable fills in a name for the connection, which you can change. The name is only used inside Lovable to identify the connection, for example
Mollie Test or Mollie Live.4
Configure the connection
Under Configure connection, enter:
- API key: paste your Mollie API key. It must start with
test_orlive_. Get value next to the field opens the API keys page in the Mollie Dashboard.
5
Choose who can use this connection
Under Sharing, the connection is private to you by default and shows a Private label. To share it, click Share with others. Then add workspace members by email, or click Invite entire workspace to make the connection available to everyone in your Lovable workspace.See Who can use connections and clients for more information.
6
Connect
Click Connect at the bottom of the form. Lovable verifies the key against the Mollie API before saving the connection.
How payments are confirmed
Mollie tells your app about a payment’s progress by calling a webhook, a public address in your app. Mollie can’t reach the editor’s preview, so Lovable sets up the webhook on a public address of your app. The webhook call only carries the payment ID, so Lovable builds your app to look up the payment in Mollie and mark the order as paid only when Mollie reports it as paid. Your app does not treat the customer’s return to your site as proof of payment. Payments made with atest_ key open Mollie’s test checkout, where you choose the outcome (paid, failed, canceled, or expired) to try each path in your app.
Limitations
The Mollie connector cannot:- Connect with an organization access token (
access_) or through Mollie Connect. Each connection uses one profile API key. - Support marketplace or platform payments where each seller connects their own Mollie account. Each connection represents a single Mollie profile shared across all projects linked to it.
Troubleshooting
Use these checks when connecting fails or a Mollie request returns an unexpected status.No suitable payment methods found
No suitable payment methods found
Mollie returns this error when no payment method is enabled on the Mollie profile for that amount and currency. Enable a method such as iDEAL or cards for that profile in the Mollie Dashboard, then try again. Test and live mode have separate payment method settings.
Manage your Mollie connection
Connections are managed from Connectors: select Mollie, then open the connection.- Unlink projects to remove Mollie access from specific projects while keeping the connection available for others. See Unlink projects from a connection for the steps.
- Delete the connection to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use Mollie stop working until a new connection is added. See Delete a connection for the steps and who can delete.