Overview
Settings → Payment Methods is where customers’ payment choices come from. Methods are stored for the current Test or Live mode and must be enabled for each sales channel.
Before you start
- Switch to the mode you are configuring (Test vs Live).
- Enable the same sales channels on the method that you use on products.
How to use it
Stripe Connect
- Open Payment Methods.
- For each mode, use Connect Live Stripe / Manage Live Stripe or Connect Test Stripe / Manage Test Stripe.
- Complete Stripe’s OAuth. Each mode has its own Stripe account connection.
- Disconnect Live Stripe or Disconnect Test Stripe removes the Stripe method for that mode (it does not delete manual methods).
Optional Terminal Location ID on the Stripe method is for kiosk tap-to-pay.
Manual methods
- Add a method.
- Set Name, Description, Status (Active/Inactive), Sales Channels, and optional limits under Limits:
- Min. Cart Subtotal Amount
- Max. Cart Subtotal Amount
- Save.
Limits apply to merchandise subtotal before discount (the same items total used in order totals). They apply on Hosted Shopfront, Kiosk, and QR Ordering:
- Checkout shows the method disabled with a reason when the cart is below min or above max (shopfront also shows a muted hint on eligible methods).
- If a customer still submits an out-of-range cart, order create returns an error and the order is not placed.
- Leave both fields empty for no limit.
Understanding the options
| Channel | Payment modes the channel can use |
|---|---|
| Hosted Shopfront | Manual, pay via gateway (Stripe) |
| QR Ordering | Manual, pay via gateway |
| Kiosk | Manual, pay via gateway, Tap to Pay, QR code payment |
Inactive methods do not appear at checkout. Methods not checked for a channel do not appear on that channel.
Important
- After Exit Test Mode, add or enable live payment methods. Connect Live Stripe if you take cards: Test Connect does not take live cards. Manual methods (cash, pay on counter, and similar) need a live copy too; Test Mode methods do not carry over.
- You can go live and set up live payment methods during the trial; see Test Mode.
Common problems
Problem
Stripe works in Test Mode but not after going live.
Solution
Open Payment Methods while in Live Mode and Connect live Stripe. Enable the method for the customer’s channel.
Problem
Cash does not show on kiosk.
Solution
Edit the manual method, check Kiosk, set Active, and save while in the same Test/Live mode as the kiosk.
Problem
A payment method appears at checkout but is greyed out, or checkout says the cart must be updated.
Solution
Open the method and check Limits. Min/max compare to items subtotal before discount, not the final total after tax, tip, or fees. Lower the minimum, raise the maximum, or ask the customer to add or remove items.
On Hosted Shopfront, pay-on-delivery methods are also disabled for delivery and scheduled orders even when limits are met: the customer must pick an online payment method.