Stripe Terminal

Overview

Stripe Terminal lets you collect an in-person card payment from the Mallard Bay mobile app using the native Terminal screen.

You may see terminal payment options while creating a Quick Pay, requesting an additional booking payment, or opening a pending payment and choosing Terminal payment.

Before You Start

Make sure terminal payments are enabled for the payment workflow you are using. When available, the app shows In Person (Terminal) as a payment method.

The terminal flow may require location and Bluetooth permissions so the app can discover and connect to a reader. If prompted, allow the requested permissions.

Collect an In-Person Payment

1. From the mobile payment workflow, choose In Person (Terminal) or Terminal payment.
2. The app opens screen_name: Terminal and shows the payment amount.
3. Choose how the customer will pay:
   • Tap to Pay: the customer taps their card on your phone.
   • Card Reader: the customer inserts or taps their card on the connected reader.
4. Wait while the app searches for a reader and connects.
5. If a required reader update appears, let the update finish before collecting payment.
6. Have the customer present their card when the app is ready.
7. Keep the app open while Mallard Bay collects, confirms, and processes the payment.

After Payment Is Processed

When the payment succeeds, Mallard Bay shows Payment processed successfully! and closes the terminal screen. The related payment or payment request is updated in Mallard Bay.

If Something Goes Wrong

If the app cannot initialize the terminal, find a reader, connect, or process the payment, it shows an error. Check that permissions are allowed, Bluetooth is available, the reader is nearby and powered on, and the payment is still pending. Then reopen the terminal payment flow and try again.