What donors see on a donation terminal
A donation terminal is a Stripe card reader running the Masjidbox donation app. The donor picks a campaign and an amount, taps or inserts their card, and Stripe processes the payment directly into your mosque's Stripe account. This page describes what donors see and do on the terminal, what the QR code after payment does, and what you see in the dashboard afterwards.
The readers
Two Stripe readers run the Masjidbox donation app:
Stripe Reader S700 — handheld, connects over Wi-Fi.
Stripe Reader T600 — self-service kiosk with an 8-inch screen, mains powered, connects over Wi-Fi or Ethernet.
You buy readers from Stripe through the shop built into the dashboard. Ordering, registration and setup are covered in Set up Stripe Terminal for in-person donations, and costs and fees in How much does a donation terminal cost and what are the fees? Campaigns are created under Donations > Campaigns (see Create and manage donation campaigns).
What donors do on the terminal
The flow is the same on both readers. Donors need no account and, for a one-time donation, give no personal information.
Choose a campaign.
Choose one-time or monthly, if the campaign offers both.
Choose an amount: a preset button, or the keypad when the campaign allows a custom amount.
Optionally choose to cover the fees.
Monthly only: enter a phone number. It receives an SMS with a link to manage the donation.
Tap or insert the card.
After payment a thank-you screen appears with a QR code. It returns to the start screen after 60 seconds by default; you can change this delay in the terminal settings.
Cards and wallets
Contactless and chip cards work, and phone wallets (Apple Pay, Google Pay, Samsung Pay) are accepted by tap, including offline. A one-time tap is anonymous: no account and no personal details are needed. A monthly donation asks for a phone number so the donor receives the management link by SMS — see Help donors manage a recurring donation.
The QR code after payment
The QR code on the thank-you screen opens the donor site with the donation's code already filled in. The donor confirms it by entering the last 4 digits of their card, and can then:
Declare Gift Aid, on UK campaigns with Gift Aid turned on
Get a receipt, or a French tax receipt (reçu fiscal)
Manage a monthly donation
Create a donor account
If the donor does not scan the QR code
The donation is kept but stays anonymous: no Gift Aid and no receipt. The donor can come back later, with no time limit.
Open the donor site.
Enter the donation code, which is also printed on their bank statement, and the last 4 digits of the card.
Without the code, the donor can search by campaign, date, amount and the card's last 4 digits.
Receipts
Terminal receipts are not automatic, because a tap carries no email address. The donor gets one by scanning the QR code after payment or from their donor account. Annual consolidated receipts exist only for French tax receipts — see Donation tax documents by country.
Gift Aid on terminal donations
Each one-time tap is a separate donation and needs its own Gift Aid declaration, made through the QR code after payment. A monthly donation declared once covers every later payment of that subscription. Recognising a returning donor never creates a Gift Aid declaration; the donor still declares through the QR code. How declarations work is covered in How Gift Aid declarations work.
Recognising returning donors
Only donors who have a donor account with that card saved online are matched, through the card's fingerprint; the match links the donation to the donor. A donor with no account is not recognised. Wallet taps (Apple Pay, Google Pay) are sometimes matched with the physical card and sometimes not, so never rely on the match.
Anonymous donations and GASDS
Terminal donations are anonymous by default. If your mosque has GASDS set up, eligible anonymous donations of GBP 30 or less are automatically added to your GASDS records — see Set up Gift Aid auto-claim (UK).
What you see after a terminal donation
Open Donations > One-time Donations and filter by source "terminal" or by terminal. Each terminal donation shows:
Field | What appears |
|---|---|
Donation | Amount, date, campaign and terminal |
Card | Card brand and last 4 digits |
Wallet | Wallet type when the donor paid by phone |
Fees | Whether the donor covered the fees |
Gift Aid | Shown when the donor declared through the QR code |
Related donations | Other donations made with the same card |
Name and email | Blank, unless the donor added them through the QR code |
Offline donations
One-time card payments can be taken offline: they are stored on the reader and sent to Stripe when it reconnects. Monthly donations are not possible offline. An offline donation only appears in your dashboard after it has been sent.
Condition or limit | Detail |
|---|---|
Reader software | Must have been updated online within the last 30 days |
Payment size | A single offline payment can be at most about USD 10,000, or the equivalent |
Card types | Physical cards and phone wallets work offline; magnetic stripe does not |
Refunds | Offline payments cannot be refunded until they have been sent |
An offline tap is only authorised when the reader reconnects and sends it. If the card is declined at that point, the money is lost and your mosque carries that risk.
Problems with a terminal
For setup, ordering and registration failures, see Troubleshoot Stripe Terminal setup and orders. For donation and Gift Aid issues, see Troubleshoot donations and Gift Aid.