Terminal

Two ways to run it

• Kiosk — a fixed tablet or reader at the door. Donors tap an amount, tap their card, done. Preset amounts, optional custom amount, nothing else on screen.
• Attended — a volunteer holds the device and walks the rows after Jumu'ah. A volunteer name on the session ties the shift to a total afterwards.

Hardware

• Android phone/tablet with Tap to Pay — the cheapest option; nothing to buy. The donor taps their card or phone on the back of yours.
• Stripe S700 / WisePad reader — a dedicated reader that pairs with the app over Bluetooth, for a counter or wall.
• Volunteers' own Android phones — attended mode, paired with the same code.

Tap to Pay has its own rules, set by Stripe and Google: the device needs Android 13 or newer, NFC and Google Mobile Services, an unmodified, locked bootloader (no rooted devices or custom ROMs) and a stable internet connection.Developer options must be switched off while taking payments — Stripe checks and refuses to collect otherwise. Emulators can't run Tap to Pay at all; the app greys the option out and offers a sandbox reader instead.

Install the app

The app is distributed through Google Play internal testing during the pilot — your onboarding email has the opt-in link; once accepted, install “WeMasjid Terminal” from the Play Store like any other app and it updates automatically. Sideloading the release APK still works if a device can't reach Play. Kiosk devices can be pinned with Android's screen-pinning / lock-task; full lockdown needs the device provisioned as device owner.

Set up

• In the admin: Terminals → Add terminal, pick kiosk or attended, a default fund, amounts and prompts.
• On the device: open the app, type the 6-character pairing code — same idea as pairing a TV — then choose Tap to Pay, a Wi-Fi reader or a Bluetooth reader.
• Re-pairing: use Unpair on the terminal's page to free the code for a new device.

A typical Friday

• Volunteer opens the app, starts an attended session with their name.
• Donors tap a preset amount (or the volunteer enters one) and tap their card — receipts and Gift Aid happen afterwards by QR, so the queue keeps moving.
• End the session: the admin Terminals page shows the shift's count and total, exportable to CSV.

Give monthly

When Offer monthly giving is on for a terminal (Terminals → Edit, on by default), donors see “Give once” or “Give monthly” after the amount. Monthly asks for an email (name optional) and shows a consent line the donor must tick — in effect: “I agree to the masjid taking this amount from this card every month, starting one month from today, until I cancel.”

The first payment is the card tap they just made; Stripe saves a reusable card for the monthly subscription, which starts charging one month later. Stripe emails a receipt each month. The donor can cancel any time at wemasjid.com/give/your-slug/manage — the same self-serve page as online recurring gifts — or by asking the masjid to cancel it from the Giving dashboard.

If something goes wrong

• “No internet — card donations are paused.” Tap to Pay can't take cards offline at all, and neither can the terminal app — the banner blocks the Give buttons until the device is back online. (Offline queuing exists only on Stripe's S700 reader and isn't wired up yet.)
• “Reader disconnected” — tap the banner to reconnect; the app also reconnects by itself when a saved reader is nearby on launch.
• Card declined / not read — the app offers Retry the card (same payment, no duplicate) or Cancel.
• Refund — in attended mode Undo last fully refunds the previous payment in the open session (within 30 minutes). Anything older is refunded from the Giving dashboard like any donation.

Gift Aid and GASDS

After paying, the device can show a QR code. The donor scans it to add a Gift Aid declaration or get an emailed receipt on their own phone — the link works for 30 days. If they skip it, card donations of £30 or under may still qualify for GASDS top-up automatically; a Gift Aid declaration replaces that (you can't claim both on one donation).

What you need first

• The masjid verified and its Stripe account connected with charges enabled — the same onboarding as online giving.
• Terminal card payments run in Stripe's live mode; test/simulated readers work in sandbox but real cards need live keys and a live connected account.