Spree Stripe

This is the official Stripe payment gateway extension for Spree Commerce open-source eCommerce platform.

This Stripe integration is bundled in the Spree Starter for your development convenience.

Or you could follow the installation instructions below.

If you like what you see, consider giving this repo a GitHub star ⭐

Thank you for supporting Spree open-source ❤️

Important

This Stripe integration for Spree is free to use for private projects but requires a Commercial License if you're planning to use it for your SaaS or a multi-tenant eCommerce website. Feel free to reach out to learn more.

Tip

Looking for a Stripe Connect integration for Spree? It's available with the Enterprise Edition.

Features

• Support for quick checkout using Apple Pay, Google Pay, Stripe Link
• Support for 3D Secure and other security standards
• Support for off-session payments
• Support for Storefront API integration (see the API docs here).
• Accept payments in over 130 currencies
• Accept Credit Cards, Apple Pay, Google Pay, and more
• Accept SEPA Direct Debit payments
• Accept iDEAL payments
• Accept SOFORT payments
• Accept Bancontact payments
• Accept Alipay payments
• Accept WeChat Pay payments
• Accept Afterpay, Klarna, Affirm, and more

What's new?

Installment (BNPL) payments indicator on PDP (Product Detail Page)

Quick payment options on the cart (Apple Pay, Google Pay, Link)

Quick payments bypassing checkout 1st step (Apple Pay, Google Pay, Link)

Various payment options on the payment step (cards, BNPL, Apple Pay, Google Pay, Link)

Installation

1. Add this extension to your Gemfile with this line:

   bundle add spree_stripe

2. Run the install generator

   bundle exec rails g spree_stripe:install

3. Restart your server

If your server was running, restart it so that it can find the assets properly.

This Stripe integration is also bundled in the Spree Starter for your development convenience.

Developing

1. Create a dummy app

   bundle update
   bundle exec rake test_app

2. Add your new code

3. Run tests

   bundle exec rspec

When testing your applications integration with this extension you may use it's factories. Simply add this require statement to your spec_helper:

require 'spree_stripe/factories'

Releasing a new version

bundle exec gem bump -p -t
bundle exec gem release

For more options please see gem-release README

Contributing

If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.

Copyright (c) 2025 Vendo Connect Inc., released under AGPL 3.0 license. Please refer to this blog post and that blog post to learn more about Spree licensing.

Looking for a Stripe Connect integration for Spree?

Spree Commerce Enterprise Edition comes with a fully automated Stripe Connect integration for a multi-vendor marketplace use case:

• Automated split payments between marketplace and vendors
• Support for multiple payment methods including cards and digital wallets
• Configurable marketplace fees and commission structures
• Automated payouts to vendors
• Comprehensive transaction reporting
• Built-in fraud prevention tools

Feel free to reach out to learn more.

Spree 5 Announcement & Demo

We’re thrilled to unveil Spree 5 — the most powerful and feature-packed open-source release in Spree Commerce’s history, including:

• A completely revamped Admin Dashboard experience: boost your team's productivity
• A Mobile-First, No-code Customizable Storefront: raise conversions and loyalty
• New integrations: a native Stripe integration, and also Stripe Connect, Klaviyo integrations available with the Enterprise Edition
• Enterprise Edition Admin Features: Audit Log, Multi-Vendor Marketplace, Multi-tenant / White-label SaaS eCommerce

Read the full Spree 5 announcement here.

Check out the Spree 5 demo for yourself, including this Stripe integration.