The Complete Guide to Setting Up Mollie Subscriptions on ...

The Complete Guide to Setting Up Mollie Subscriptions on Shopify: A Step-by-Step Tutorial

Meta Description: Master Mollie Shopify subscription setup with our comprehensive technical guide. Learn to configure recurring payments, webhooks, and go live in under an hour. Perfect for European merchants.

Why Mollie Subscriptions Matter for Your Shopify Store

If you're running a Shopify store in Europe, you've likely faced the subscription payments dilemma. Recurring revenue is the holy grail of e-commerce—predictable cash flow, higher customer lifetime value, and the foundation of sustainable growth. Yet for years, European merchants have been stuck between two frustrating options: expensive enterprise solutions with feature bloat they don't need, or cobbled-together workarounds that break at scale.

Mollie changed the game. As Europe's leading payment provider, they've built a subscription engine that actually understands European commerce: SEPA direct debits for German customers, iDEAL recurring for the Netherlands, and full PSD2 compliance out of the box. No more explaining to Dutch customers why they can't use their preferred payment method for subscriptions.

But here's the catch: while Mollie's subscription functionality is powerful, the technical setup isn't exactly plug-and-play. Webhook configuration trips up even experienced developers. Test mode behaviors confuse merchants. And the documentation—though comprehensive—assumes you already know what you're doing.

This guide solves that problem. By the end, you'll have a fully functional Mollie subscription setup on your Shopify store, tested and ready for production. No guesswork. No missing steps. Just a working system.

Prerequisites: What You Need Before Starting

Before diving into configuration, ensure you have the following ready:

Shopify Requirements

Shopify Plan: Basic plan or higher (subscriptions require checkout modification)
Store Currency: Must match your primary Mollie account currency
Legal Pages: Terms of service and privacy policy published (required for subscriptions)
Products: Physical or digital products configured with inventory tracking

Mollie Account Requirements

Verified Business Account: Personal accounts cannot process subscriptions
Website Profile: Your Shopify store URL must be added and verified
Bank Account: Connected for payouts (SEPA region bank account recommended)
VAT Number: Required for B2B subscription billing in most EU countries

Supported Payment Methods for Subscriptions

[Table: | Payment Method | Countries | First Payment | Recurring | Notes | |---------------|-----------|----...]

Important: Not all Mollie payment methods support recurring billing. Only the methods marked with ✅ for "Recurring" can be used for subscription products.

Step 1: Setting Up Your Mollie Account for Subscriptions

First, let's configure your Mollie dashboard for subscription handling.

1.1 Enable Subscription Products

[IMAGE: Mollie dashboard showing the "Subscriptions" menu item in the left sidebar navigation]

Log into your Mollie Dashboard
Navigate to Settings → Website Profiles
Select your Shopify store profile
Click Products in the submenu
Toggle Subscriptions to "Enabled"
Review and accept the Subscription Terms of Service

1.2 Configure Webhook URLs

Webhooks are critical for subscription management. They notify your Shopify store when payments succeed, fail, or when customers cancel.

[IMAGE: Mollie webhook settings page showing the webhook URL input field]

In your Mollie Dashboard:

Go to Settings → Webhooks
For Webhook URL, enter:

   https://your-store.myshopify.com/apps/mollie/webhook

Replace your-store with your actual Shopify subdomain.

Set Description to: "Shopify Subscription Webhook"
Enable All payment status changes
Enable Subscription-specific events:

Subscription created
Subscription updated
Subscription canceled
Payment succeeded
Payment failed
Payment charged back

1.3 Generate API Keys

You'll need both test and live API keys:

[IMAGE: Mollie API keys page showing Test API key and Live API key sections]

Navigate to Developers → API Keys
Copy your Test API Key (starts with test_)
Click Create Live API Key if you haven't already
Copy your Live API Key (starts with live_)
Store these securely—they grant full account access

Security Note: Never commit API keys to version control. Use Shopify's native environment variables or a secrets manager.

Step 2: Installing the Mollie App on Shopify

With your Mollie account configured, let's connect it to Shopify.

2.1 Install from Shopify App Store

[IMAGE: Shopify App Store showing the official Mollie app with "Install" button]

In your Shopify admin, go to Apps → Shopify App Store
Search for "Mollie" (verify it's the official app by Mollie B.V.)
Click Add app
Review permissions:

Orders: Manage orders and view order details
Products: View and modify products
Storefront: Access storefront data
Customers: View customer information
Settings: Manage payment settings

Click Install app

2.2 Initial App Configuration

After installation, you'll be redirected to the Mollie app settings:

[IMAGE: Mollie app configuration screen in Shopify admin showing API key input]

Select Environment: Start with "Test" mode
Enter your Test API Key from Step 1.3
Click Connect to Mollie
Verify the connection status shows "Connected"

Test Mode First: Always begin in test mode. Mollie's test environment simulates real payment flows without actual money movement, letting you verify everything works before going live.

Step 3: Configuring the API Connection

Now we'll configure the technical connection between Mollie and Shopify for subscription handling.

3.1 Payment Method Activation

[IMAGE: Mollie app payment methods page showing enabled methods like SEPA and iDEAL]

In the Mollie app:

Go to Payment Methods
Enable methods that support recurring billing:

SEPA Direct Debit (essential for EU-wide coverage)
iDEAL (Netherlands-specific)
Credit Card (Visa/Mastercard)
PayPal (if applicable)

Configure method-specific settings:

SEPA: Enable "Mandate via first payment"
iDEAL: Enable "iDEAL Recurring"
Credit Card: Require 3D Secure for first payment

3.2 Webhook Verification

The app should automatically configure webhooks, but let's verify:

# Test webhook endpoint accessibility
curl -X GET https://your-store.myshopify.com/apps/mollie/webhook \
  -H "Authorization: Bearer YOUR_API_KEY"

Expected response: {"status": "ok", "webhook_active": true}

[IMAGE: Webhook test response showing successful connection status]

3.3 Order Status Mapping

Configure how Mollie payment statuses map to Shopify order statuses:

[Table: | Mollie Status | Shopify Order Status | Recommended Action | |--------------|---------------------|...]

In the Mollie app:

Navigate to Advanced Settings → Status Mapping
Verify the mappings align with your fulfillment workflow
Enable "Auto-cancel on expired payments" for subscriptions

Step 4: Creating Your First Subscription Product

With the connection established, let's create a subscription product.

4.1 Product Setup in Shopify

[IMAGE: Shopify product creation page showing subscription app block in the sidebar]

In Shopify admin, go to Products → Add product
Enter product details:

Title: "Premium Coffee Subscription"
Description: Include subscription terms and cancellation policy
Price: €29.99 (monthly recurring price)

Scroll to Subscriptions section (added by Mollie app)
Enable "This is a subscription product"

4.2 Subscription Configuration

[IMAGE: Mollie subscription configuration panel showing interval options]

Configure the subscription parameters:

Billing Interval: Monthly
Interval Count: 1 (every 1 month)
Trial Period: 7 days (optional)
Signup Fee: €0 (or one-time setup fee)
Initial Payment: Prorated (or full period)
Minimum Commitment: 3 months (optional)

Key Settings Explained:

Prorated Billing: Customers pay a partial amount if signing up mid-cycle. Good for aligning all renewals to the 1st of the month.
Trial Period: Offer a free/discounted first period. Requires clear communication to avoid chargeback disputes.
Minimum Commitment: Lock customers in for a period (e.g., 3 months). Useful for high-value physical subscriptions.

4.3 Variant-Specific Subscriptions

If your product has variants (e.g., sizes), configure subscriptions per variant:

[IMAGE: Variant-specific subscription settings showing different prices for different sizes]

Click Manage subscription settings per variant
Set variant-specific pricing:

Small: €24.99/month
Medium: €29.99/month
Large: €34.99/month

Enable/disable subscription option per variant as needed

4.4 Save and Verify

Click Save
View the product on your storefront
Verify the subscription widget appears with correct pricing
Check that the "Subscribe and save" option is clearly visible

Step 5: Testing the Subscription Flow

Before going live, thoroughly test the entire customer journey.

5.1 Test Mode Checkout

[IMAGE: Shopify storefront showing subscription product with "Subscribe" button and interval selector]

Visit your storefront in an incognito window
Add a subscription product to cart
Proceed to checkout
Use Mollie's test payment credentials:

Test Card:

Number: 4111 1111 1111 1111
Expiry: Any future date
CVC: Any 3 digits

Test iDEAL:

Select any test bank
Use status "Success" for successful flow

Test SEPA:

IBAN: NL53INGB0654422370
BIC: INGBNL2A

5.2 Verify Webhook Events

After test checkout, verify webhooks fired correctly:

[IMAGE: Mollie dashboard webhook logs showing successful deliveries with green checkmarks]

In Mollie Dashboard, go to Developers → Webhook Logs
Look for recent events with status "200 OK"
Verify these events occurred:

payment.created
payment.paid (or payment.authorized)
subscription.created

5.3 Test Subscription Management

As a customer would:

[IMAGE: Customer account page showing active subscriptions with "Manage" button]

Create a customer account on your store
Complete a test subscription purchase
Go to Account → Subscriptions
Test these actions:

View subscription details
Update payment method
Skip next delivery
Cancel subscription

Verify each action triggers correct Mollie API calls

5.4 Test Failed Payment Scenarios

Subscription reliability depends on handling failures gracefully:

# Simulate failed payment via Mollie test mode
curl -X POST https://api.mollie.com/v2/payments \
  -H "Authorization: Bearer test_xxxxxxxx" \
  -d "amount[currency]=EUR" \
  -d "amount[value]=29.99" \
  -d "method=creditcard" \
  -d "status=failed"

[IMAGE: Failed payment email notification showing retry instructions for customer]

Verify:

Customer receives dunning email
Subscription status changes to "On hold"
Retry payment button works
After 3 failures, subscription cancels automatically

Step 6: Going Live Checklist

Once testing is complete, follow this checklist before enabling live payments.

6.1 Pre-Launch Verification

[ ] All webhook events received successfully in test mode
[ ] Subscription products display correctly on storefront
[ ] Checkout flow completes without errors
[ ] Customer account subscription management works
[ ] Email notifications send correctly
[ ] Failed payment flows tested
[ ] Cancellation process verified
[ ] Refund process documented

6.2 Switch to Live Mode

[IMAGE: Mollie app settings showing toggle between Test and Live environment]

In Mollie app settings, toggle Environment to "Live"
Enter your Live API Key
Click Connect
Verify "Connected" status

6.3 Live Webhook Configuration

Update webhook URL to production:

https://your-store.myshopify.com/apps/mollie/webhook

Verify in Mollie Dashboard that webhooks are hitting the production endpoint.

6.4 Compliance and Legal

[ ] Terms of Service include subscription cancellation terms
[ ] Privacy Policy covers recurring payment data storage
[ ] VAT settings configured for subscription billing
[ ] Cancellation policy clearly stated on product pages
[ ] Customer support process documented for subscription issues

6.5 Monitoring Setup

Configure alerts for critical subscription events:

[IMAGE: Mollie dashboard notification settings showing webhook failure alerts]

In Mollie Dashboard, go to Settings → Notifications
Enable email alerts for:

Webhook failures
Failed subscription payments
Chargeback notifications
High dispute rates

In Shopify, set up order notifications for subscription orders

Common Pitfalls to Avoid

After helping hundreds of merchants set up Mollie subscriptions, here are the most common issues and how to avoid them:

Currency Mismatch

Problem: Store currency doesn't match Mollie account currency. Solution: Both must use the same currency. If you sell in EUR, your Mollie account must process EUR. Multi-currency stores need multiple Mollie website profiles.

Webhook Failures

Problem: Webhooks fail silently, causing order status mismatches. Solution:

Never block Mollie's IP ranges
Return 200 OK immediately upon receiving webhooks
Process webhook data asynchronously
Monitor webhook logs weekly

VAT on Subscriptions

Problem: VAT calculated incorrectly on recurring payments. Solution:

Enable "VAT included in price" for B2C subscriptions
Use Shopify Tax for automatic VAT calculation
Verify Mollie passes correct VAT amounts

Chargeback Handling

Problem: Subscription chargebacks aren't tracked properly. Solution:

Set up Mollie dispute notifications
Track chargeback rate per subscription cohort
Implement early warning for high-risk payment methods

Customer Communication

Problem: Customers forget they subscribed and dispute charges. Solution:

Send pre-billing notification emails (3 days before)
Include clear "Manage Subscription" links
Make cancellation easy—mandatory in EU anyway

Conclusion: Your Subscription System Is Ready

You've now built a production-ready subscription system on Shopify using Mollie. From account configuration to live payment processing, every critical component is in place.

What you've accomplished:

✅ Connected Mollie to Shopify with proper webhook handling
✅ Created subscription products with flexible billing options
✅ Tested the complete customer journey end-to-end
✅ Configured monitoring and failure handling
✅ Switched to live mode with compliance checks complete

Your next steps:

Monitor the first week closely—watch webhook logs and payment success rates
Optimize your subscription offering—test different billing intervals and pricing
Build retention—implement dunning emails and win-back campaigns
Scale thoughtfully—subscriptions compound; ensure fulfillment can handle growth

European e-commerce is moving toward subscriptions. With Mollie handling the payment complexity and this guide handling the setup, you're positioned to capture predictable, recurring revenue while your competitors still struggle with payment method limitations.

Start small. Test with a few products. Measure what works. Then scale.

Ready to launch? Your subscription infrastructure is waiting.

Need help with a specific integration challenge? Our team has implemented Mollie subscriptions for 50+ Shopify stores. [Contact us for implementation support](#).

JSON-LD Structured Data

{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "The Complete Guide to Setting Up Mollie Subscriptions on Shopify: A Step-by-Step Tutorial",
  "description": "Master Mollie Shopify subscription setup with our comprehensive technical guide. Learn to configure recurring payments, webhooks, and go live in under an hour.",
  "keywords": "mollie shopify subscription setup, shopify recurring payments, mollie subscriptions europe, shopify sepa direct debit, shopify subscription tutorial",
  "author": {
    "@type": "Organization",
    "name": "Subora"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Subora",
    "logo": {
      "@type": "ImageObject",
      "url": "https://subora.eu/logo.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://subora.eu/blog/mollie-shopify-subscription-setup-guide"
  },
  "datePublished": "2026-04-17",
  "dateModified": "2026-04-17",
  "articleSection": "E-commerce Payments",
  "wordCount": 2050,
  "proficiencyLevel": "Intermediate",
  "dependencies": "Shopify, Mollie Payment Platform",
  "step": [
    {
      "@type": "HowToStep",
      "position": 1,
      "name": "Setting Up Your Mollie Account for Subscriptions",
      "text": "Enable subscription products in Mollie dashboard, configure webhook URLs, and generate API keys."
    },
    {
      "@type": "HowToStep",
      "position": 2,
      "name": "Installing the Mollie App on Shopify",
      "text": "Install the official Mollie app from Shopify App Store and connect using test API keys."
    },
    {
      "@type": "HowToStep",
      "position": 3,
      "name": "Configuring the API Connection",
      "text": "Activate payment methods that support recurring billing and verify webhook endpoints."
    },
    {
      "@type": "HowToStep",
      "position": 4,
      "name": "Creating Your First Subscription Product",
      "text": "Configure subscription parameters including billing intervals, trial periods, and variant-specific pricing."
    },
    {
      "@type": "HowToStep",
      "position": 5,
      "name": "Testing the Subscription Flow",
      "text": "Complete test transactions using Mollie test credentials and verify webhook events."
    },
    {
      "@type": "HowToStep",
      "position": 6,
      "name": "Going Live Checklist",
      "text": "Switch to live API keys, update webhooks, verify compliance, and configure monitoring."
    }
  ]
}

Word Count: ~2,100 words Reading Time: 9 minutes Technical Difficulty: Intermediate Last Updated: April 17, 2026

Subora Team

Subscription operators

Practical notes from the team working on Shopify subscriptions, recurring billing, and subscriber self-service flows.

Relevant product lane

Native Shopify subscriptions for European recurring revenue.

Explore Subora

The Complete Guide to Setting Up Mollie Subscriptions on Shopify: A Step-by-Step Tutorial