{"id":11252,"date":"2024-08-20T17:36:16","date_gmt":"2024-08-20T17:36:16","guid":{"rendered":"https:\/\/spreecommerce.org\/?post_type=cpt_integrations&#038;p=11252"},"modified":"2025-10-14T11:58:43","modified_gmt":"2025-10-14T11:58:43","slug":"stripe-integration-with-spree","status":"publish","type":"cpt_integrations","link":"https:\/\/spreecommerce.org\/integrations\/stripe-integration-with-spree\/","title":{"rendered":"Stripe and Spree Commerce integration"},"content":{"rendered":"\n<p>The integration of Stripe with your Spree Commerce store can be done quickly and easily following the guidelines mentioned below.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Integrate Stripe with Spree<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"483\" src=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-Commerce-open-source-eCommerce-Stripe-payments-integration-Github-1024x483.jpg\" alt=\"\" class=\"wp-image-12625\" srcset=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-Commerce-open-source-eCommerce-Stripe-payments-integration-Github-1024x483.jpg 1024w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-Commerce-open-source-eCommerce-Stripe-payments-integration-Github-300x142.jpg 300w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-Commerce-open-source-eCommerce-Stripe-payments-integration-Github-768x362.jpg 768w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-Commerce-open-source-eCommerce-Stripe-payments-integration-Github-1536x725.jpg 1536w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-Commerce-open-source-eCommerce-Stripe-payments-integration-Github-2048x966.jpg 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Here are the <a href=\"https:\/\/github.com\/spree\/spree_stripe?tab=readme-ov-file#installation\">Stripe installation instructions<\/a> or you could simply use the pre-configured <a href=\"https:\/\/github.com\/spree\/spree_starter\/\">Spree Starter<\/a> which bundles all the must-haves and saves you a lot of time.<\/p>\n\n\n\n<p><a href=\"https:\/\/github.com\/spree\/spree_stripe\">This gem<\/a> is the official Stripe payment gateway extension for&nbsp;Spree Commerce. It is the first native Stripe integration with all the features that Stripe provides:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Support for quick checkout using Apple Pay, Google Pay, Stripe Link<\/li>\n\n\n\n<li>Support for 3D Secure and other security standards<\/li>\n\n\n\n<li>Support for off-session payments<\/li>\n\n\n\n<li>Support for Storefront API integration (see the API docs&nbsp;<a href=\"https:\/\/spreecommerce.org\/docs\/api-reference\/storefront\/stripe\">here<\/a>).<\/li>\n\n\n\n<li>Accept payments in over 130 currencies<\/li>\n\n\n\n<li>Accept Credit Cards, Apple Pay, Google Pay, and more<\/li>\n\n\n\n<li>Accept SEPA Direct Debit payments<\/li>\n\n\n\n<li>Accept iDEAL payments<\/li>\n\n\n\n<li>Accept SOFORT payments<\/li>\n\n\n\n<li>Accept Bancontact payments<\/li>\n\n\n\n<li>Accept Alipay payments<\/li>\n\n\n\n<li>Accept WeChat Pay payments<\/li>\n\n\n\n<li>Accept Afterpay, Klarna, Affirm, and more<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Installment (BNPL) payments indicator on PDP (Product Detail Page)<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"483\" src=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-BNPL-Installment-payments-Product-Card-PDP-Product-Detail-Page-1024x483.jpg\" alt=\"Installment (BNPL) payments indicator on PDP (Product Detail Page)\" class=\"wp-image-12629\" srcset=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-BNPL-Installment-payments-Product-Card-PDP-Product-Detail-Page-1024x483.jpg 1024w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-BNPL-Installment-payments-Product-Card-PDP-Product-Detail-Page-300x142.jpg 300w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-BNPL-Installment-payments-Product-Card-PDP-Product-Detail-Page-768x362.jpg 768w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-BNPL-Installment-payments-Product-Card-PDP-Product-Detail-Page-1536x725.jpg 1536w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-BNPL-Installment-payments-Product-Card-PDP-Product-Detail-Page-2048x966.jpg 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Quick payment options on the cart (Apple Pay, Google Pay, Link)<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"483\" src=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payment-options-on-the-cart-1024x483.jpg\" alt=\"Quick payment options on the cart (Apple Pay, Google Pay, Link)\" class=\"wp-image-12627\" srcset=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payment-options-on-the-cart-1024x483.jpg 1024w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payment-options-on-the-cart-300x142.jpg 300w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payment-options-on-the-cart-768x362.jpg 768w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payment-options-on-the-cart-1536x725.jpg 1536w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payment-options-on-the-cart-2048x966.jpg 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Quick payments bypassing checkout  (Apple Pay, Google Pay, Link)<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"483\" src=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payments-bypassing-checkout-on-Cart-1024x483.jpg\" alt=\"Quick payments bypassing checkout  (Apple Pay, Google Pay, Link)\" class=\"wp-image-12628\" srcset=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payments-bypassing-checkout-on-Cart-1024x483.jpg 1024w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payments-bypassing-checkout-on-Cart-300x142.jpg 300w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payments-bypassing-checkout-on-Cart-768x362.jpg 768w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payments-bypassing-checkout-on-Cart-1536x725.jpg 1536w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Quick-payments-bypassing-checkout-on-Cart-2048x966.jpg 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Various payment options on the payment step (cards, BNPL, Apple Pay, Google Pay, Link)<a href=\"https:\/\/github.com\/spree\/spree_stripe#various-payment-options-on-the-payment-step-cards-bnpl-apple-pay-google-pay-link\"><\/a><a href=\"https:\/\/github.com\/spree\/spree_stripe#quick-payments-bypassing-checkout-1st-step-apple-pay-google-pay-link\"><\/a><a href=\"https:\/\/github.com\/spree\/spree_stripe#quick-payment-options-on-the-cart-apple-pay-google-pay-link\"><\/a><\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"483\" src=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Checkout-payment-step-1024x483.jpg\" alt=\"Various payment options on the payment step (cards, BNPL, Apple Pay, Google Pay, Link)\" class=\"wp-image-12626\" srcset=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Checkout-payment-step-1024x483.jpg 1024w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Checkout-payment-step-300x142.jpg 300w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Checkout-payment-step-768x362.jpg 768w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Checkout-payment-step-1536x725.jpg 1536w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2024\/08\/Spree-x-Stripe-Apple-Pay-Google-Pay-Link-Checkout-payment-step-2048x966.jpg 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p><a href=\"https:\/\/github.com\/spree\/spree_stripe#installment-bnpl-payments-indicator-on-pdp-product-detail-page\"><\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Spree 5 Demo<a href=\"https:\/\/github.com\/spree#spree-5-demo\"><\/a><\/h2>\n\n\n\n<p>Check out this\u00a0<a href=\"https:\/\/demo.spreecommerce.org\/\">Spree Commerce demo<\/a>\u00a0using the official Stripe integration.<\/p>\n\n\n\n<p>This demo runs on the upcoming Spree 5 which is the biggest Spree release ever. This milestone is more than just an upgrade. It transforms the platform into a future-ready, mobile-first, no-code, enterprise-friendly eCommerce solution that still adheres to its open-source roots.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Legacy integration<\/h2>\n\n\n\n<p>Thanks to available Spree extensions, you can easily integrate various types of payment methods. To configure one of the supported payment gateways (e.g. Stripe), you must first install the&nbsp;<a href=\"https:\/\/github.com\/spree\/spree_gateway\" target=\"_blank\" rel=\"noreferrer noopener\">Spree_Gateway<\/a>&nbsp;extension in your store.<\/p>\n\n\n\n<p>Once the extension has been installed, you can configure Stripe payment gateway in the Admin Interface by clicking the \u201c<em>Configuration &gt; Payment Methods<\/em>\u201d tab and then clicking the \u201cNew Payment Method\u201d button.<\/p>\n\n\n\n<p>Search&nbsp;<strong>\u2018Stripe\u2019<\/strong>&nbsp;in Providers drop down and&nbsp;select&nbsp;<em>Spree&nbsp;::&nbsp;:: Gateway StripeGateway<\/em>.<\/p>\n\n\n\n<p>In the next steps you will be asked to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Choose payment method name that will be displayed to your customers&nbsp;e.g. Credit Card<\/li>\n\n\n\n<li>Set display value, whether you want the payment method to appear on the front-end or the back-end of your store, or both.<\/li>\n\n\n\n<li>Choose auto capture<\/li>\n<\/ul>\n\n\n\n<p>If you set it as false then authorization will be done at purchase time but actual charge will be done when the order is marked as shipped. If you set it as true then the payment will be captured just after authorization at purchase time.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Activate the payment method in your store<\/li>\n<\/ul>\n\n\n\n<p>At the end of the process,&nbsp;you will be asked to enter \u2018SECRET KEY\u2019 and \u2018PUBLISHABLE KEY\u2019. You will need a Stripe account for that. After log in you can see API tab in sidebar. By clicking the API tab, you can see \u2018API keys\u2019 section and you can find \u2018Publishable key\u2019 and \u2018Secret key\u2019 key there. These are your testing credentials. You need to \u2018Activate your account\u2019 from side bar to get live API keys.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Example of Stripe and Spree integration<\/h2>\n\n\n\n<p><a href=\"https:\/\/goop.com\/\">Goop<\/a>&nbsp;originated as Gwyneth Paltrow\u2019s homespun weekly newsletter. Now it\u2019s an eCommerce platform that&nbsp;brags&nbsp;over 1 million monthly unique viewers. It is built with Spree and uses Stripe as its payment gateway .<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" width=\"1601\" height=\"963\" src=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2019\/01\/example-of-Stripe-and-Spree-Commerce-Integration.jpg\" alt=\"example of Stripe and Spree Commerce Integration\" class=\"wp-image-2269\" srcset=\"https:\/\/spreecommerce.org\/wp-content\/uploads\/2019\/01\/example-of-Stripe-and-Spree-Commerce-Integration.jpg 1601w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2019\/01\/example-of-Stripe-and-Spree-Commerce-Integration-300x180.jpg 300w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2019\/01\/example-of-Stripe-and-Spree-Commerce-Integration-768x462.jpg 768w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2019\/01\/example-of-Stripe-and-Spree-Commerce-Integration-1024x616.jpg 1024w, https:\/\/spreecommerce.org\/wp-content\/uploads\/2019\/01\/example-of-Stripe-and-Spree-Commerce-Integration-600x361.jpg 600w\" sizes=\"(max-width: 1601px) 100vw, 1601px\" \/><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>The integration of Stripe with your Spree Commerce store can be done quickly and easily following the guidelines mentioned below.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_acf_changed":false,"_seopress_robots_primary_cat":"","_seopress_titles_title":"Stripe and Spree Commerce integration","_seopress_titles_desc":"","_seopress_robots_index":""},"cpt_integrations_category":[986],"class_list":["post-11252","cpt_integrations","type-cpt_integrations","status-publish","hentry","cpt_integrations_category-payment"],"acf":[],"_links":{"self":[{"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/cpt_integrations\/11252","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/cpt_integrations"}],"about":[{"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/types\/cpt_integrations"}],"wp:attachment":[{"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/media?parent=11252"}],"wp:term":[{"taxonomy":"cpt_integrations_category","embeddable":true,"href":"https:\/\/spreecommerce.org\/wp-json\/wp\/v2\/cpt_integrations_category?post=11252"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}