Skip to content

Payments

Saved Payment Methods (Card on File)

Customers save a card during deposit checkout or via a self-manage link. Operator can charge against the saved card for walk-out checkout, late cancellation fees, and no-show fees with consent enforced server-side.

Last updated

Customers save a card during deposit checkout or via a self-manage link. The card persists on the customer profile so you can run walk-out checkout, late cancellation fees, and no-show fees - all with consent enforced server-side.

Where to find it - Web: Customer profile → card-on-file badge near the contact info. Booking detail: card status surfaces near cancellation/no-show fee banners. Mobile: same surfaces.

TL;DR

  • Customer saves a card via deposit checkout, self-manage link, or staff-assisted.
  • OpenChair stores brand + last 4 + expiry + consent record; Stripe stores the actual card.
  • Operator can charge against the saved card for walk-out checkout, late cancellation fees, no-show fees.
  • Owner-only removal (security).
  • Available on every plan with Stripe Connect active.

How a customer saves a card

During deposit checkout

When a customer pays a deposit at storefront booking, the payment intent is created with a parallel SetupIntent so Stripe can persist the card on your Connect account. The customer doesn't see a separate "save card" step - Stripe handles it inline. If they have Stripe Link enabled, the experience is one-tap on future Stripe-powered checkouts.

Via My Account

Customers open My Account → Payments on the venue storefront. They can add or update their card using Stripe's secure payment form and remove an existing card after confirmation.

The booking page's Manage card link opens this account section. Existing signed links with panel=payment also lead here after booking access is verified. Account sign-in is required because saved cards belong to the customer's venue account.

A card update stays pending until the server confirms the saved card. Check again retries a delayed confirmation. Payment errors retain the form or existing card so the customer can retry.

Staff-assisted

From the customer profile, you can:

  1. Tap Send card-update link - emails the customer a fresh signed link to add/update their card
  2. The customer completes via their email; no further operator action needed
  3. The card-on-file badge updates automatically once the customer completes

Useful when a customer's card needs updating and you don't have them in person.

What OpenChair stores

Field What it is
Card brand Visa, Mastercard, Amex, etc.
Last 4 digits For display only
Expiry month/year For UI display and expiry checks
Consent status consented / revoked / not_consented
Consent timestamp When the customer agreed
Consent source booking_flow / manage_portal / in_venue / staff_assisted
Consent version The terms version they agreed to
Last used at When you last charged against this card

Full card numbers and CVVs are stored by Stripe, never by OpenChair. When you charge, the request goes to Stripe with our reference token; Stripe handles the actual card data.

Card status

Status What it means
Active Card is on file, consented, ready to use
Needs update Card is on file but expired or payment-method validation failed; customer should update
Removed Card has been detached
Disputed A charge against this card was disputed; charging is paused pending resolution

What you can do with a saved card

Action Where it surfaces Doc
Walk-out checkout (one-tap charge after appointment) Checkout view when booking is ready Walk-Out Checkout
Late cancellation fee Booking detail banner when status = cancelled Cancellation & No-Show Fees
No-show fee Booking detail banner when status = no_show Cancellation & No-Show Fees

All three require:

  • Card on file with status Active
  • Consent status Consented
  • Card not expired (month/year vs current)
  • Customer's email or phone matches the booking

Server-side checks all four before the charge fires. Missing any one returns a friendly error message ("Customer card is not active", "Customer has not consented to card-on-file charges", "Card has expired", "No card on file").

Customer consent

Consent is captured per-card per-customer when they add the card. The customer explicitly agrees to off-session charging at one of:

Source Where they agreed
booking_flow Storefront checkout (deposit step)
manage_portal Self-manage link they clicked from an email
in_venue Staff-assisted in-person enrolment
staff_assisted Staff sent them a link they completed on their own device

Consent versioning means if you change your terms, future charges check the latest version. Customers with older consent need to re-consent (rare, only when terms change materially).

Removing a card

Two paths:

Customer-initiated

The customer signs into My Account → Payments and chooses Remove card. After confirmed removal from Stripe, OpenChair updates the saved payment-method record and customer summary together. If removal cannot be confirmed, the card stays visible with a retry option.

Operator-initiated (owner only)

From the customer profile, the owner can tap Remove card on file. Confirmation dialog. Same effect as customer removal.

Why owner-only: a compromised staff account shouldn't be able to remove cards on file - that's the rail for no-show fee recovery. Security posture SEC-027.

Sending a card-update link

If a customer's card is expired or needs replacing:

  1. Open the customer profile
  2. Tap Send card-update link
  3. Customer receives an email with a signed link to their most recent booking's manage page
  4. They open Payments, sign into their venue account if needed, and add or update their card
  5. Card-on-file status updates automatically

No reply needed from the customer; the system detects the update via Stripe webhook.

Tier

All plans. Requires Stripe Connect active on your venue.

Mobile parity

Mobile booking detail shows the card-on-file badge and supports the cancellation/no-show fee charging flow. Customer profile shows the card-on-file status. Removing a card and sending an update link is web-only (owner-only actions).

Charging mechanics

When you trigger a charge against the saved card, OpenChair calls Stripe with:

  • off_session: true (the customer isn't actively present)
  • confirm: true (charge immediately, don't wait for authorisation)
  • The venue's Stripe Connect account
  • An idempotency key so retries don't double-charge
  • An application fee for OpenChair's platform fee

Failures (declined, insufficient funds, network) are logged with full audit context in paymentChargeAudit so you can trace what happened.

Common mistakes

Problem What to check
Card on file says "Needs update" Card expired or Stripe webhook flagged a validation failure. Send the customer a card-update link.
"Customer has not consented" error Consent record is missing or revoked. Customer needs to re-add the card via the manage portal.
Can't see Remove Card button Only owners can remove. Manager and stylist accounts see status but can't detach.
Customer says they saved a card but it's not showing Confirm the customer's email matches the booking they used. The card-on-file lookup uses the venue customer record; mismatched email creates two records.
Want to migrate cards from another system Card data can't be migrated by us - Stripe doesn't accept raw card data from third parties. Customers need to re-enter.

Related Articles

Common questions

How does a customer save a card on file?

Customers can save a card during supported deposit checkout or in My Account Payments. Staff can send a card-update link; the customer signs in and completes the secure form on their device.

What does 'card on file' let me do?

Charge against the saved card for walk-out checkout (one-tap charge after the appointment), late cancellation fees, and no-show fees. All charges require the customer to have explicitly consented to off-session card use.

Why can't I see the customer's full card number?

Card details (full number, CVV) are stored by Stripe, not by OpenChair. We only see and display brand + last 4 + expiry. The customer can update or remove their card in My Account Payments after signing in.

Who can remove a saved card?

Customers can remove their own saved card in My Account Payments. Among venue operators, only the owner can detach a card; manager and stylist accounts cannot.

Still need a hand?

Get in touch with a question about your venue or account.

Contact our team