Skip to content

Card Readers

Connect a physical card reader so customers can pay in person without you typing in their card number. BridalOp supports readers from both Stripe Terminal and Square, depending on which payment gateway your shop is connected to.

Go to Settings > Card Readers to pair and manage your devices.

Supported Hardware

The readers below connect to the internet directly and pair with BridalOp through the settings page. All are standalone WiFi devices — no companion app or laptop tether required.

Stripe Terminal

DeviceConnection
BBPOS WisePOS EWiFi
Stripe Reader S700 / S710WiFi

Square

DeviceConnection
Square TerminalWiFi
Square RegisterWiFi

Bluetooth & Tap to Pay not yet supported

The cheaper $49 Bluetooth readers (Stripe Reader M2, Square Reader) and Tap to Pay on iPhone / Android are not supported yet. iPad Safari and other browsers can't access the secure-element or Bluetooth APIs these devices require — they'll ship as part of a future iPad companion app. For now, use one of the standalone WiFi readers above.

Pair a Stripe Reader

You'll need Stripe connected as your gateway under Payment Settings and the reader powered on and connected to WiFi.

1. Get a Registration Code from the Reader

The reader needs to display a registration code (a three-word string like quick-brown-fox) so you can register it with BridalOp. There are two ways to surface that code — either works on the BBPOS WisePOS E and Stripe Reader S700 / S710:

Option A — Quick shortcut (fastest):

Enter the sequence 0-7-1-3-9 on the reader. The screen flips straight to a Registration Code display.

Option B — Settings menu:

On the reader, open Settings and tap Generate pairing code. The same registration code appears on the screen.

2. Register the Reader in BridalOp

  1. Go to Settings > Card Readers and click Pair Stripe Reader.
  2. Pick the Location the reader belongs to. (If you haven't created the location yet, set it up under Locations first.)
  3. Paste the Registration Code from the reader's screen.
  4. Give the reader a Label — a staff-friendly name like "Front Counter" or "Back Office Reader".
  5. Click Pair Reader.

The new reader appears in your readers list with an Active badge. If the device goes offline (loses WiFi or powers down), the badge flips to Offline until it reconnects.

Pair a Square Device

You'll need Square connected as your gateway under Payment Settings and the Square Terminal or Register set up on your network.

1. First-Time Square Terminal Setup

If this is a brand-new device — or one that's been factory reset — Square Terminal asks you to connect to a network the first time you power it on. Square Terminal supports both WiFi and Ethernet:

Connect through WiFi:

  1. Select your preferred network from the list of available networks.
  2. Enter the network password if one is required.

Connect through Ethernet:

Plug the Ethernet cable into the dock — Square Terminal picks up the connection automatically.

Once the device is online, leave it on the Sign in with device code screen and switch back to BridalOp.

2. Generate a Device Code in BridalOp

  1. Go to Settings > Card Readers and click Pair Square Device.
  2. Pick the Location the device belongs to and give it a Label (for example, "Counter Square").
  3. Click Generate Code — BridalOp displays a device code.

3. Sign In on the Square Device

  1. On the Square Terminal, tap Sign in with device code.
  2. Enter the code shown in BridalOp.

BridalOp polls Square in the background. The modal flips to Paired automatically once Square confirms (usually within 30 seconds) and the new device appears in your readers list with an Active badge.

Charge a Card on a Reader

From the POS

  1. Add items to the sale and click Pay.
  2. Pick Card on Reader as the payment method.
  3. Choose the reader (the option only appears when at least one reader is paired for the active gateway).
  4. Click Charge — a Charge on Reader waiting screen appears.
  5. The customer taps, dips, or swipes on the device.
  6. The sale finalizes automatically and the receipt screen comes up.

From an Invoice

  1. Open the invoice and click Record Payment.
  2. Pick Card on Reader, choose the reader, and click Charge Reader.
  3. The same waiting screen appears. Once the customer pays, the invoice balance updates and the payment is recorded.

Cancel a Charge in Progress

Click Cancel on the waiting screen. The reader resets and the order or invoice stays unpaid — pick a different payment method or try again.

Reader Statuses

Each reader in the list shows a status badge:

StatusMeaning
Active (green)Online and ready to accept charges
Offline (amber)The device hasn't checked in recently — likely powered off or off WiFi
Removed (gray)You unpaired the reader; it no longer appears in the POS payment picker

Click Remove on any reader to unpair it. Removed readers stop showing up as a charge target, but their historical payments stay attached to the orders and invoices they were used on.

Tipping

BridalOp can ask customers for a tip in two places, controlled by two independent toggles under Settings > Payments:

ToggleWhere the tip prompt appears
Tip Prompts on ReadersOn the card reader's screen during a POS card-on-reader charge — the customer picks the tip on the device before the sale finalizes
Tip Prompts on Invoice Payment PagesOn the public invoice payment page when a customer pays an invoice via the emailed link — preset percentages (1% / 3% / 5%), Custom, and No Tip

Either or both can be on at the same time. Both feed the same reporting — tip totals appear in the Tips report under Reports.

Invoice tips need a Sold By

Invoice tip prompts are hidden when the invoice's Sold By field is empty (there's no one to credit). Set Sold By on the invoice — or carry it forward from the source order — before sending if you want the prompt to show.

Gateway Mismatch

The Card Readers page shows both a Stripe Terminal and Square Terminal section regardless of which gateway is active, but the section that doesn't match your active gateway is dimmed with a note like "Your POS is on Square — switch gateways in Settings > Payments to use these."

If you set your default POS gateway to Stripe but haven't connected Stripe (or vice versa), an amber banner appears at the top of the Card Readers page reminding you to connect that gateway before pairing readers.

Troubleshooting

Reader shows "Offline" in the readers list

  • Confirm the device is powered on and connected to WiFi.
  • For Stripe: check the device's screen and make sure no firmware-update modal is blocking it — pending updates put readers in a temporarily-unreachable state.
  • For Square: make sure the device is signed in to the same Square location you connected to BridalOp.

Charge fails with "No reader available"

  • The reader may have gone offline mid-charge. Check the device, then retry.
  • Stripe occasionally returns this when the reader is mid-firmware-update. Wait a couple of minutes and try again.

Customer wasn't prompted for a tip

  • For POS sales: confirm Tip Prompts on Readers is on under Settings > Payments.
  • For invoice payments via the public link: confirm Tip Prompts on Invoice Payment Pages is on under Settings > Payments, and that the invoice has a Sold By consultant set (the prompt is hidden when Sold By is empty).
  • The two toggles are independent — turning one on doesn't enable the other.

Charge succeeded on the device but the order didn't update in BridalOp

  • BridalOp falls back to a webhook from Stripe / Square when a browser closes mid-tap. Reload the order page — it should now show as paid.
  • If the payment still hasn't reflected after about 60 seconds, contact support.