Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Mollie for Spree Commerce

Build Status Gem Version

This is the official Mollie payment gateway for Spree Commerce. Implement this to easily accept all major payment methods, including iDEAL, Bancontact, Visa, Mastercard, AmEx, and many more, in your Spree Commerce storefront.

This gateway supports all aspect of Spree Commerce and payments can be created through both spree_frontend and spree_api.

Please go to the signup page to create a new Mollie account and start receiving payments in a couple of minutes.

Our pricing is always per transaction. No startup fees, no monthly fees, and no gateway fees. No hidden fees, period.

  1. Features
  2. Requirements
  3. Installation
  4. Configuring Mollie Gateway
  5. API endpoints
  6. Upgrading
  7. API documentation
  8. Want to help us make our API client even better?
  9. License
  10. Support


  • Support for all available Mollie payment methods.
  • Multicurrency payments
  • Support for one-click payments.
  • Fast in-house support. You will always be helped by someone who knows our products intimately.
  • Multiple translations: English and Dutch.
  • Refund orders from the Spree admin.
  • Event log for debugging purposes.
  • Available for spree_api and spree_frontend.
  • Allow returning customers to use their previous payment details and pay instantly.


  • Spree 3.5 or newer.


  1. Add the extension to your Gemfile using:
gem 'spree_mollie_gateway'
  1. Install the gem by running bundle install.

  2. Run the installer which takes care of copying migrations:

bundle exec rails g spree_mollie_gateway:install

Configuring Mollie Gateway

Add new Payment Method.

  1. Configure a new payment method (Spree Admin -> Configurations -> Payment Methods -> New Payment Method).
  2. Select Spree::Gateway::MollieGateway as a Provider.
  3. Fill in your live / test API key.
  4. Fill in your hostname. Used for generating the webhook URL and redirect URL.
  5. Select "Front End" in the Display selectbox.
  6. Save and you're done!

API endpoints

This gateway comes with a couple of API endpoints which seamlessly integrate with the Spree API.


API documentation

If you wish to learn more about our API, please visit the Mollie API Documentation.

Want to help us make our API client even better?

Want to help us make our API client even better? We take pull requests, sure. But how would you like to contribute to a technology oriented organization? Mollie is hiring developers and system engineers. Check out our vacancies or get in touch.


BSD (Berkeley Software Distribution) License. Copyright (c) 2014-2019, Mollie B.V.


Contact: — +31 20-612 88 55