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

Device	Connection
BBPOS WisePOS E	WiFi
Stripe Reader S700 / S710	WiFi

Square

Device	Connection
Square Terminal	WiFi

Square Register is not compatible

A Square Register cannot be paired with BridalOp. Entering the pairing code on one returns "Unsupported Square Product". This is a limit of Square's own platform — their Devices and Terminal APIs do not support Register hardware — so it is not something we can add. Use a Square Terminal.

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 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.

Cancelling can't recall a payment the customer has already made

Once she taps, the payment exists — it's taken at that moment by the card network, not when the screen catches up. A gateway will refuse to cancel a charge it has already taken, and the only way back is a refund.

If she taps before the cancel lands, BridalOp now tells you so: you get the receipt and the payment on the order, not a cancellation that didn't happen. Refund it from the order if that's what you want. Previously the screen reported "cancelled" either way, which is how a sale could be rung a second time.

Reader Statuses

Each reader in the list shows a status badge:

Status	Meaning
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:

Toggle	Where the tip prompt appears
Tip Prompts on Readers	On 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 Pages	On 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

• Stripe: a webhook picks it up when a browser closes mid-tap. Reload the order page — it should show as paid within about 60 seconds.
• Square: there's no equivalent webhook, so a charge taken while the till was closed or offline may not be recorded. Don't ring it again. Start the charge on that order as normal: before arming the reader, BridalOp checks whether that sale already has a payment it never recorded, and if it finds one it records that and shows you the receipt instead of taking the card twice.
• A charge you've already refunded is never pulled back in this way.
• If the payment still hasn't reflected, contact support with the time and amount — it can be traced against your gateway in minutes.