Skip to content

How to set up payment methods and Stripe

Add manual methods (cash and similar) and connect Stripe for card payments. Live and Test are separate.

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

  1. Open Payment Methods.
  2. For each mode, use Connect Live Stripe / Manage Live Stripe or Connect Test Stripe / Manage Test Stripe.
  3. Complete Stripe’s OAuth. Each mode has its own Stripe account connection.
  4. 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

  1. Add a method.
  2. Set Name, Description, Status (Active/Inactive), Sales Channels, and optional limits under Limits:
    • Min. Cart Subtotal Amount
    • Max. Cart Subtotal Amount
  3. 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.