Enabling Mollie
Connect a Mollie account using your Test or Live API key, test checkout with Mollie's simulator, and configure optional cart limits.
Updated
Connect Mollie under Settings > Payments to accept hosted online payments through your Mollie account. When a customer selects Mollie at checkout, Nevuto creates a payment session and redirects the customer to Mollie's hosted checkout screen before returning them to your store.
Before you start
- Sign in as the store owner or with a staff account that has permission to manage Payments. Staff accounts without Payments permission cannot open the Mollie settings page.
- Have an eligible Mollie merchant account with a website profile created in your Mollie Dashboard. Mollie serves businesses registered in the European Economic Area (EEA), the UK and Switzerland; complete Mollie's onboarding and website profile activation before accepting live payments.
- Confirm that your store currency is supported by the Mollie integration:
AED,AUD,BGN,BRL,CAD,CHF,CZK,DKK,EUR,GBP,HKD,HUF,ILS,ISK,JPY,MXN,MYR,NOK,NZD,PHP,PLN,RON,RUB,SEK,SGD,THB,TWD,USDorZAR. While this guide uses USD examples, a USD store currency does not by itself establish merchant eligibility outside Mollie's supported regions. - Copy your Test API key (
test_...) and Live API key (live_...) from Developers > API keys in your Mollie Dashboard.
Open the Mollie setup
- In your Nevuto admin, go to Settings > Payments.
- Click Add payment in the upper-right corner, then select Add payment provider.
- In the Add payment method modal, enter Mollie in Enter payment method. Clear any category tab filter if it hides the result.
- Select the Mollie card to open its setup form.
If Mollie is already configured on your store, click its row on Settings > Payments or open the row's three-dot menu and select Manage. Opening the setup form does not connect or activate Mollie until you submit valid credentials. Select any screenshot to view it at full size.
Match Mollie API keys to the Nevuto fields
In your Mollie Dashboard, open Developers > API keys to copy the Live API key (live_...) and Test API key (test_...) for your website profile. See Mollie's guide to connecting and processing payments for details.
Match your Mollie keys to the fields in Nevuto:
- Secret key: Your Mollie Live API key (starts with
live_). - Public key: Optional. You can leave this blank or store your Mollie Profile ID (
pfl_...) for reference. If you enter a value in Public key during initial setup, you must also enter your Secret key. - Sandbox secret key (inside Sandbox mode): Your Mollie Test API key (starts with
test_). - Sandbox public key (inside Sandbox mode): Optional. Leave blank or store your profile identifier alongside Sandbox secret key.
Don't
Do not include a Bearer prefix when pasting your API key, and do not paste your live_... or test_... API key into the Public key field alone. Keep API keys private and out of screenshots, emails and support tickets.
Configure sandbox mode
- In the Mollie setup form under Configure API keys, click Sandbox mode to expand the test fields.
- Paste your Mollie Test API key (
test_...) into Sandbox secret key. You can leave Sandbox public key and the live fields empty while setting up only sandbox testing. - Turn on Enable sandbox mode so Nevuto uses your test API key.
- Turn on Enable payment status when you want Mollie offered at checkout during your test.
- Review Payment Limits if you want to restrict Mollie by cart total.
- Click Submit in the upper-right corner and wait for the confirmation toast.
When you click Submit, Nevuto validates the active API key with Mollie before saving. On a successful first save, Nevuto returns to Settings > Payments. Reopen Mollie to confirm that your key and mode were stored.
In the Payments list, Active or Inactive indicates whether customers see Mollie at checkout, while Sandbox or Live shows which credential environment is active.
This screenshot shows an unsaved example. All four credential fields are intentionally empty and Enable payment status is off. Enter your own Mollie Test API key (test_...) in Sandbox secret key before clicking Submit.
Test the hosted checkout flow
When you use a Mollie Test API key (test_...), Mollie replaces real bank or card authorization with its hosted test checkout simulator, where you can choose the final payment status directly (such as Paid, Failed, Canceled or Expired) without entering card numbers. See Mollie's testing guide for details on how test mode works.
To test the customer flow after saving your sandbox setup:
- Add a product to your storefront cart in a supported currency (such as USD or EUR) and proceed to checkout.
- Select Mollie as the payment method and continue to Mollie's hosted test checkout screen.
- Select a payment method enabled on your Mollie profile, choose Paid on Mollie's test status simulator, and continue back to your store.
- Confirm that the order is marked as paid in Nevuto and appears under Transactions > Payments in your Mollie Dashboard when Test mode is toggled on.
- Place another test checkout and choose Canceled or Failed on Mollie's test screen to verify that unpaid sessions return the customer to checkout without marking the order as paid.
An Active badge in Settings > Payments only confirms that your API key passed the save-time check; always verify a complete checkout round-trip before switching to live mode.
Set payment limits
Use Payment Limits to control which cart totals can use Mollie at checkout. Turn on the Payment Limits switch and enter a Minimum Cart Amount and Maximum Cart Amount in your store currency. The minimum amount cannot exceed the maximum amount.
Tip The $50–$500 USD range shown above is a prepared unsaved example, not a saved store setting or required range. Turn Payment Limits off if you do not want a custom cart-total restriction in Nevuto. Click Submit after editing limits and reopen the form to confirm they were stored.
Switch to live payments
After your test checkouts succeed and your Mollie website profile is approved for live payments:
- In your Mollie Dashboard, open Developers > API keys and copy the Live API key (
live_...) for your store's website profile. - In Nevuto, open Settings > Payments and select Mollie.
- Paste your Live API key (
live_...) into Secret key. - Expand Sandbox mode and turn off Enable sandbox mode.
- Confirm Enable payment status and Payment Limits are set as intended.
- Click Submit and verify that Settings > Payments lists Mollie as Active in Live mode. Reopen Mollie to confirm your live key is stored.
Your test_... key can remain in Sandbox secret key; turning off Enable sandbox mode switches Nevuto to your live API key.
Edit or deactivate Mollie
Open Mollie from Settings > Payments (or select Manage from the row's three-dot menu ) any time you need to rotate API keys, switch modes or update cart limits. Submit stays disabled until you change a field on the form.
To stop offering Mollie at checkout without deleting your keys, turn off Enable payment status and click Submit, or open the three-dot menu on the Mollie row in Settings > Payments and choose Deactivate. Choosing Delete from the three-dot menu removes the saved Mollie configuration from your store. Deactivating or deleting Mollie only affects new checkouts and does not cancel or refund past orders. Because Nevuto does not process Mollie refunds from the order screen, issue any post-payment refunds directly from your Mollie Dashboard.
Troubleshooting
Was this guide helpful?