Muin is in private beta.Watch the public release announcement —talk to us.
Falaah Falaah AI

QuickPay Setup — Android donation kiosk

Turn any Android tablet into an always-on QuickPay donation kiosk: hardware checklist, Device Owner provisioning, campaign assignment, and receipt setup.

QuickPay is Muin’s single-tap, fixed-amount kiosk mode for Android tablets — the fastest possible donor experience (one pre-set amount, NFC auto-active, no picker). This guide walks through the full setup — from “I have a tablet” to “donors are tapping and giving” — in about ten minutes for the first device and three to five minutes for each additional device. For broader payment kiosks (amount picker, fund picker, attract modes), see the Kiosks + QuickPay product page.

Hardware checklist

Before starting, confirm your tablet meets the minimums.

RequirementWhy
Android 8.0 (Oreo / SDK 26) or laterDevice Owner mode and Stripe Terminal SDK minimums
NFC-capable (contactless reader built in)Required for Tap-to-Pay
Google Play Services installedStripe Terminal SDK uses Play Services
Wi-Fi or cellular dataOffline queue handles up to 24 hours; steady connection recommended
2 GB RAM or moreEnsures kiosk mode runs reliably for multi-hour sessions
A power outlet or charging dock at the deploy locationQuickPay is always-on; you want it on AC power

Optional but useful:

  • A kiosk floor stand or lockable counter mount ($15–$40 on Amazon)
  • A Bluetooth or USB ESC/POS receipt printer (if printing receipts on-site)

What doesn’t work:

  • iPads — no iOS equivalent for Device Owner always-on mode. Use Tap-to-Pay on iPhone (separate product) for iOS.
  • Phones — technically possible, but NFC antenna placement and small screens make for a poor donor experience.
  • Tablets without NFC — Muin Go POS mode may still work for card-only giving, but Tap-to-Pay is off the table.

Step 1 — Install Muin Go

  1. On the tablet, open the Google Play Store
  2. Search for Muin Go and install
  3. Open the app and sign in with your Muin admin credentials

You’ll land on the app home screen with the standard module menu.

Step 2 — Enable Kiosk Mode (Device Owner provisioning)

Device Owner is an Android primitive that lets one app fully lock the device to its own screen. Provisioning differs slightly by Android version and device vendor.

Easy path — QR enrollment (most modern tablets):

  1. Reboot the tablet to factory settings (Settings → System → Reset). This is the cleanest path. Skip this step if the tablet is new out-of-box.
  2. During the setup wizard, tap the clock six times on the welcome screen. You’ll see a QR scanner.
  3. In the Muin web admin, go to Payments → Terminals → Add kiosk, select the campaign, and click Generate enrollment QR.
  4. Scan the QR with the tablet. Android installs Muin Go as Device Owner automatically.
  5. Confirm prompts on the tablet; sign in to Muin Go.

Manual path (fallback):

  1. Install Muin Go as described in Step 1
  2. In Muin Go, navigate to Settings → Kiosk Mode
  3. Tap Enable Kiosk Mode. The app prompts for Device Owner enablement.
  4. Follow the on-screen instructions — typically “enable USB debugging, run a shell command from a connected computer” on older tablets. The app shows the exact command.

After Device Owner is enabled, Muin Go becomes the home screen. Pressing home, recent apps, or notifications does nothing — the device is locked to the app.

Step 3 — Assign a campaign

From the Muin web admin:

  1. Navigate to Payments → Terminals
  2. Find your newly provisioned device in the list (it appears as “online”)
  3. Click the device and configure:
    • Campaign — which campaign or fund this device will collect for
    • Preset amounts — the buttons donors tap (e.g., $5 / $20 / $50 / custom)
    • Receipt delivery — email, SMS, WhatsApp, printed (if printer attached), or QR code for donor-scan
    • Attract screen (optional) — idle display between taps; options include a static graphic, a live thermometer, or a donor-wall
    • Fee-covering prompt (optional) — ask the donor if they’d like to cover the Stripe processing fee
  4. Click Push to device

Configuration updates within a few seconds. The tablet transitions to the live QuickPay screen.

Step 4 — First tap

Hand a card, phone, or watch to a colleague and ask them to tap the NFC region (usually the back center of the tablet). The Stripe Terminal SDK tokenizes the payment, QuickPay processes the charge, and the receipt fires via the chosen channel.

At this point the device is production-ready.

Receipt channel details

ChannelRequiresDonor experience
EmailDonor types or has an email on fileStandard HTML receipt email; auto-arrival within a minute
SMSDonor’s phone number on file or entered on deviceText message with link to full receipt
WhatsAppDonor’s WhatsApp number on file (Twilio-enabled)WhatsApp message with receipt link
PrintESC/POS receipt printer (USB or Bluetooth)Instant printed slip; good for events
QRNone; device generates a QR on-screenDonor scans with their phone; receipt opens on their browser

Attract screen modes

When no donor is tapping, QuickPay can display:

  • Static branding — your logo + campaign name
  • Live thermometer — real-time fundraising progress
  • Donor wall — recent donors’ first names + amounts (opt-in per donor)
  • Impact counter — total raised today / this week / this campaign

All configurable from Payments → Terminals → [device] → Attract screen.

Deploying multiple devices

After the first device, subsequent tablets take ~3 minutes each because you re-use the enrollment QR:

  1. Reboot each new tablet to factory (if needed)
  2. Scan the same campaign’s enrollment QR during setup
  3. Device auto-enrolls as a second QuickPay kiosk under the same campaign

To split devices across campaigns, generate a separate enrollment QR per campaign.

Switching a device to a different campaign

You don’t reprovision. From the web admin:

  1. Navigate to Payments → Terminals
  2. Click the device
  3. Change the assigned campaign
  4. Click Push to device

Updates within a few seconds. The tablet transitions to the new campaign’s screen.

Offline behavior

QuickPay’s offline queue holds up to 24 hours of transactions. When connectivity is lost:

  • New transactions are confirmed on-device with the donor; the tablet shows a subtle “offline queue” indicator
  • Receipts fire as soon as the device regains connectivity
  • The ledger posts the transactions with their original timestamps

If the tablet is offline for more than 24 hours, it will refuse new tap-to-pay charges until connectivity is restored — the Stripe Terminal SDK requires periodic sync for security.

Security model

  • Card data never touches the tablet or Muin’s servers. The NFC read goes directly to Stripe Terminal, which returns a tokenized payment intent.
  • No PCI scope expansion for your organization — you’re using Stripe’s certified Terminal flow.
  • Device Owner mode prevents navigation away, Settings access, or notification shade pulls. A donor cannot reach anything outside the donation flow.
  • Lost or stolen device: unassign it from the web admin; the tablet can no longer process transactions even if reconnected.

Troubleshooting

IssueCauseResolution
QR enrollment not scanningTablet’s camera in low-light or clock-tap not registeredUse manual path (Step 2, fallback); reboot to factory and retry
”NFC not available” messageTablet lacks NFC, or NFC disabled in SettingsCheck hardware spec; if NFC exists, re-enable via Settings before locking to kiosk
Device shows offline in web adminWi-Fi dropped or IP changedCheck Wi-Fi on the tablet; reconnecting restores web-admin visibility
Receipts not arrivingChannel misconfigured or delivery blockedIn Payments → Terminals → [device] → Receipt Delivery, run Test receipt; check delivery logs
Donor typed wrong email; can’t resend receiptPost-tap workflowFrom the admin transaction detail page, click Resend receipt and edit the email
Device Owner provisioning failedTablet already enrolled to another managerFactory reset the tablet; re-provision fresh
Printed receipts not printingPrinter paired but offline, or paper jamCheck printer power + pairing; clear jam; Test print from admin