Stripe is included with Spree out of the box, so you can take card payments by connecting an account rather than installing anything first.
Reviewing Your Payments
The page has three sections:- Payment providers - Outside providers that process cards and wallets, such as Stripe. Each has a card with its logo and status: Active, Disabled or Not connected. The switch on a card turns a connected provider on or off.
- Manual payment methods - Methods your store handles itself, such as Check and Store Credit. Each row shows the method’s name, its description, and badges for its status and for Admin only methods.
- Payment capture - When customers are charged, for every method that doesn’t set its own. See When to Charge Customers below.
Ordering Methods at Checkout
Click Checkout order at the top of the page. A panel lists the methods customers can choose at checkout, which are the active ones visible on the storefront, in the order checkout shows them. Drag a method by its handle to move it, and put your most-used method at the top. Each move saves straight away. Providers and manual methods share one order, so a manual method can come before a provider.How to Add a Payment Method
To connect an outside provider, click Connect on its card under Payment providers. A panel opens with that provider already chosen. To add a method your store handles itself, click Add manual method under Manual payment methods, then choose its type.
Choosing a provider
The provider decides what actually processes the payment, and which settings appear afterwards. There are two kinds. Payment providers, such as Stripe, connect to an outside payment processor. They need credentials from that provider, which you enter in the same panel while creating the method. Manual payment methods need no credentials because nothing is being processed elsewhere:- Check - Records that a customer will pay by cheque or bank transfer. The order is created and your team marks it paid when the money arrives.
- Store Credit - Lets customers pay with credit already on their account.
- Custom Payment Source Method - A generic method for payment arrangements handled outside Spree, such as an account customer paying on invoice.
Provider configuration
Third-party providers need credentials before they will work. The fields differ by provider, and they appear in the panel as soon as you choose one.
Naming and visibility
These settings decide how a method is displayed:- Name - What customers see at checkout, such as “Credit card” or “Pay by invoice”.
- Description - The customer-facing description shown at checkout, useful for explaining what happens next on anything other than a card payment.
- Visible on storefront - On by default. When off, only staff see this option, which is what you want for methods used on back-office orders and manual entry.
- Active - On by default. Inactive methods are hidden from checkout entirely.
Visible on storefront and Active do different jobs. Turning off Visible on storefront keeps a method available to your team; turning off Active withdraws it from everyone.
When to charge customers
This decides the moment a customer’s money actually moves. Set the store default under Payment capture on the Payments page, and click Save to apply it. Every method follows that default unless you override it in its own panel.
Which one suits depends on how quickly you fulfil:
At checkout is the simplest and suits stores shipping in-stock goods promptly. The money is in before you pack, and reconciliation is straightforward because every order has a payment against it.
On dispatch suits made-to-order goods, pre-orders and anything with a wait, where charging weeks before a customer receives anything invites complaints and refunds. The amount is reserved at checkout so you know the card is good, and taken when the parcel leaves.
Manually suits orders that need a person to decide, such as a business order awaiting approval, a quote being finalised, or an order shipping in parts. Staff take the payment when they are ready.
Click Create payment method when you are done.
How to Edit a Payment Method
Click Configure on a provider’s card, or click a manual method’s row, to update the name, description, visibility, status or credentials. The edit panel shows the provider in its subtitle rather than as a dropdown. The provider cannot be changed once a method exists. If you need a different provider, create a new method and disable the old one.How to Delete a Payment Method
Open the method’s panel and click Delete. Spree confirms that the method will no longer be available at checkout.Disabling a method is usually better than deleting it. Turning Active off withdraws it from checkout while keeping it attached to the orders that used it.
Further Reading
- Taxes - Whether tax follows the shipping or the billing address
- Processing Orders - Taking a payment that was reserved rather than captured
- Issue Store Credits - Adding credit that the Store Credit method can spend

