Setting up Mollie for online payments on the webshop

Introduction: What is Mollie?

Mollie is an online payment system that allows customers to pay directly on your webshop before they receive their products. It works like paying in a regular online shop: customers choose their products, go to checkout, pay online (with iDEAL, credit card, etc.), and only then are the products shipped.

Why use Mollie?

You want to use Mollie because:

• Customers pay directly before you ship products
• You don't risk customers not paying
• It's professional and trusted by online shoppers
• Customers can use multiple payment methods (iDEAL, credit card, PayPal, etc.)
• It's safe for both you and the customer
• You have certainty of payment before shipping goods
• It works automatically (no more manual invoices)

Note: There are other payment systems, but Mollie is supported by default in Easyflor and is therefore the easiest choice.

How do you set up Mollie?

Setup is done in two main steps: first you need to create a Mollie account, and then you need to link Mollie to Easyflor.

---

Step 1: Creating a Mollie account

Before you can use Mollie in Easyflor, you first need a Mollie account.

Requesting a Mollie account

To the Mollie website

1. Go to https://www.mollie.com/nl
2. You're now on the Mollie website
3. Click "Sign up" or "Create free account"

Create account

1. Fill in your business details:
   • Company name
   • Chamber of Commerce number
   • Contact details
   • Bank account number (where the money should go)
2. Follow the steps on the Mollie website
3. Confirm your email address
4. Mollie verifies your details (this can take 1-2 working days)

Get Mollie API key

After approval you get access to your Mollie dashboard:

1. Log in to your Mollie account
2. Go to "Developers"
3. Click on "API keys"
4. You now see two types of keys:
   • Test API key: For testing (starts with "test_...")
   • Live API key: For real payments (starts with "live_...")
5. Copy the Live API key (you need this for Easyflor)

Important: Keep this key safe! You need it for the next step.

---

Step 2: Linking Mollie to Easyflor

Now you'll link Mollie to your Easyflor system. You need to do this in two places.

Option A: Let Easyflor BV do it for you (Recommended)

The easiest way:

1. Send your Mollie API key to Easyflor BV
2. Easyflor BV sets everything up for you
3. You don't have to do anything yourself
4. Everything is correctly configured

Contact Easyflor BV:

• Send an email or call support
• Pass on your Mollie API key
• Easyflor BV configures both locations for you
• You receive notification when it's done

---

Option B: Setup yourself (For advanced users)

If you want to do it yourself, you have to fill in the Mollie key in two different places in Easyflor.

⚠️ IMPORTANT: If you do this yourself, you must fill in both locations. If you forget one, Mollie won't work properly!

---

Location 1: Admin → Configuration → Mollie

To the first location

1. Go to "Admin"
2. Click on "Configuration"
3. Find and click on "Mollie"
4. You now see the Mollie configuration screen

Fill in API key

1. Find the field for "API key" or "Mollie key"
2. Paste here your Live API key that you got from Mollie
3. Example: live_1234567890abcdefghijklmnopqrstuv
4. Click "Save"

Extra settings (optional):

• Webhook URL (usually filled in automatically)
• Payment methods you want to offer
• Other Mollie settings

Check:

1. Check if the key is correctly saved
2. No error messages? Then it worked
3. Continue to location 2

---

Location 2: Shop (New) → Mollie

To the second location

1. Go to the "Shop (New)" tile
2. Click on "Mollie" (in the menu or configuration)
3. You see another Mollie configuration screen

Fill in API key (again)

1. Find the field for "API key" or "Mollie key"
2. Paste here the same Live API key as in location 1
3. This must be exactly the same key!
4. Click "Save"

Extra webshop settings:

• Which payment methods are visible on the webshop
• Payment page settings
• Other shop-specific Mollie options

Check:

1. Check if the key is correctly saved
2. Both locations now have the same key
3. No error messages? Done!

---

Step 3: Testing

Now that Mollie is set up, you must test if it works.

Make a test order

1. Go to your webshop (as if you were a customer)
2. Add a product to the shopping cart
3. Go to checkout
4. You should now see payment options (iDEAL, credit card, etc.)
5. Choose a payment method
6. Make a test payment

Note: For a real test you need the Test API key (otherwise you really pay money). Ask Easyflor BV for help with testing.

What should work:

• Payment options are visible
• You're redirected to the payment page
• After payment you return to your webshop
• The order is registered
• You see the payment in your Mollie dashboard

Done! Mollie now works on your webshop.

---

Practical examples

Example 1: New webshop with Mollie

• Situation: You start a new webshop and want immediate online payment
• Action:
  1. Create Mollie account via mollie.com
  2. Copy your Live API key
  3. Send key to Easyflor BV
  4. Easyflor BV sets everything up
  5. Test the webshop
• Result: Customers can pay online before you ship

Example 2: Existing webshop expanded with payment

• Situation: Your webshop already works, but customers pay afterwards
• Problem: Sometimes payment doesn't happen
• Solution:
  1. Create Mollie account
  2. Link to Easyflor
  3. From now on: pay first, then ship
• Result: No more payment risk

Example 3: Self setup goes wrong

• Situation: You fill in the key yourself but it doesn't work
• Problem: You only filled in one location instead of two
• Solution:
  1. Check both locations (Admin AND Shop)
  2. Fill in both with the same key
  3. Save in both places
• Result: Now it works

---

Important tips

Tip 1: Let Easyflor BV do it

• This is the safest and easiest option
• They know exactly what needs to happen
• Everything is correctly set up
• Saves you time and stress

Tip 2: Filling in both locations is mandatory

• If you do it yourself: don't forget both places
• Admin → Configuration → Mollie
• Shop (New) → Mollie
• Same key in both places!

Tip 3: Keep your API key safe

• Never give your Live API key to others (except Easyflor BV)
• Store it in a safe place
• If you lose it, you can create a new one in Mollie

Tip 4: Test first with Test API key

• First use the Test API key to test
• Then you don't actually pay
• If everything works, replace it with the Live API key

Tip 5: Check your Mollie dashboard regularly

• Here you see all payments
• Check if payments come in
• View statistics

Tip 6: Inform customers

• Let customers know they can pay online
• Mention which payment methods you accept
• This builds trust

Frequently asked questions

Question: What does Mollie cost?

• Mollie charges per transaction
• Costs are listed on mollie.com
• Usually a small percentage + fixed amount
• No subscription costs

Question: Which payment methods does Mollie support?

• iDEAL (most used in the Netherlands)
• Credit card (Visa, Mastercard, American Express)
• PayPal
• Bancontact (Belgium)
• And more
• You choose which ones you offer

Question: When do I get the money?

• Usually within 1-2 working days
• The money is transferred to your bank account
• You see this in your Mollie dashboard

Question: What if a customer can't pay?

• Then the order doesn't go through
• The customer gets an error message
• Possibly problem with bank or limit
• Customer must try again

Question: Can I disable Mollie later?

• Yes, anytime
• Remove the API key from Easyflor
• Or disable Mollie in the settings

Question: Do I have to make invoices myself?

• No, this happens automatically
• After payment the order is processed
• Easyflor automatically creates an invoice

What to do with problems?

Problem: Payment options not visible on webshop

• Check if Mollie is filled in at both locations
• Verify the API key is correct
• Check if Mollie is activated in webshop settings
• Refresh the webshop cache

Problem: Payment failed

• Check if you're using Live API key (not Test)
• Check Mollie dashboard for error messages
• Test with another payment method
• Verify your Mollie account is approved

Problem: Money doesn't come in

• Check your Mollie dashboard
• May take 1-2 days
• Check if your bank account number is correct in Mollie
• Contact Mollie support

Problem: Key doesn't work

• Check if you copied the Live key (not Test)
• Check there are no spaces before or after
• Did you fill it in at both locations?
• Try copying the key again from Mollie

Problem: Don't know which key to use

• For testing: Test API key (starts with "test_")
• For real payments: Live API key (starts with "live_")
• Always use Live key in production

Summary

Setting up Mollie for online payments on your webshop is done in two steps:

Step 1 - Create Mollie account:

• Go to https://www.mollie.com/nl and create an account
• Fill in your business details and wait for approval (1-2 days)
• Log in to Mollie → Developers → API keys → copy your Live API key (starts with "live_...")

Step 2 - Link to Easyflor (two options):

• Option A (recommended): Send your Mollie API key to Easyflor BV, they set everything up for you
• Option B (do it yourself): Fill in the API key in TWO places:
  1. Admin → Configuration → Mollie → fill in API key → Save
  2. Shop (New) → Mollie → fill in same API key → Save

Why Mollie:

• Customers pay online before you ship (no payment risk)
• Supports iDEAL, credit card, PayPal and more
• Safe and professional for online shopping
• Automatic processing without manual invoices

Note: If you do it yourself, don't forget to fill in both locations with exactly the same key, otherwise Mollie won't work correctly!