Accept In-Person Payments
Use Stripe Terminal hardware to accept tap, chip, and swipe card payments at your location.
Resytech integrates with Stripe Terminal to accept card-present payments using physical card readers. This is used for both booking payments from the dashboard and point-of-sale (POS) orders. The card reader connects to Stripe through your dashboard, and payments are processed in real time.
Prerequisites
- A connected Stripe account (see Set Up Stripe).
- A registered Stripe Terminal reader (see Register a Terminal).
- The POS module enabled if you are processing POS orders (see Set Up POS).
How Card-Present Payments Work
Card-present payments use the card_present payment method type in Stripe, which is different from standard online card payments (card). The flow is:
- A payment intent is created on the server with
card_presentas the payment method type. - The payment intent is forwarded to the Stripe Terminal reader.
- The customer taps, inserts, or swipes their card on the reader.
- Stripe processes the payment and returns a result.
- The payment is recorded in Resytech.
Process a Terminal Payment on a POS Order
- Navigate to Dashboard > POS.
- Create or open a pending order.
- Click Pay with Terminal.
- The system creates a PaymentIntent and sends it to your connected terminal reader.
- Prompt the customer to present their card.
- Once the card is read and payment succeeds, the order is updated:
- A
PosOrderPaymentrecord is created with the card brand and last 4 digits. - The payment type is set to
card-present. - If the order is fully paid, the status changes to Completed.
- A
Cancel a Terminal Payment
If the customer changes their mind or the reader has issues:
- Click Cancel Payment on the order.
- The pending PaymentIntent is canceled in Stripe.
- The order returns to pending status so you can try again or use a different payment method.
Process a Terminal Payment on a Booking
For bookings, card-present payments follow the same flow as any card payment but use a terminal reader instead of manual card entry:
- Open the booking and click Add Payment.
- Select Card and choose the terminal reader.
- Enter the amount.
- The customer presents their card on the reader.
- On success, the payment is recorded and the booking balance is updated.
Alternative: Charge a Saved Card
If the customer has a card on file from a previous transaction, you can charge it without the terminal:
- On the POS order or booking, select Charge Saved Card.
- Choose the saved payment method (showing brand and last 4 digits).
- Enter the amount (or leave blank to charge the full amount due).
- The card is charged off-session (no reader needed).
This is useful when the customer is not physically present or you want to avoid using the terminal.
Record a Manual In-Person Payment
For cash, check, or other non-card payments collected at the counter:
- On the order or booking, select the manual payment option.
- Choose the payment type (cash, check, etc.).
- Enter the amount and any reference information.
- Click Save.
See Process a Payment for full details on manual payment types and fields.
Payment Types Reference
| Payment Type | Code | Description |
|---|---|---|
| Card Present (terminal) | card-present | Tap, chip, or swipe on a Stripe Terminal reader |
| Card Not Present (online) | card-not-present | Card entered manually or charged from saved method |
| Cash | cash | Physical cash |
| Check | check | Paper check |
| Electronic | electronic | Zelle, Venmo, Cash App, etc. |
Tips
- Keep the terminal reader charged and connected to Wi-Fi. If the reader is offline, terminal payments will fail.
- Terminal payments have automatic capture -- the payment is captured immediately, unlike some online flows that may use manual capture.
- Card-present transactions have lower dispute rates because the cardholder is physically present, which makes fraud less likely.
- If the terminal payment fails, you can fall back to manual card entry by selecting the standard card payment flow instead.
- Terminal readers must be registered to your Stripe Terminal Location before they can accept payments. See Register a Terminal for setup instructions.
What to Do Next
- Set Up POS -- configure the full POS module for selling products.
- Register a Terminal -- connect a physical card reader.
- Process a Payment -- learn about all payment types including online cards and manual payments.
