Payments & sales
Donations (core)
This manual is a draft and may change.
What it does
Donations lets people give your organisation a one-off gift or a weekly, monthly or yearly gift. It records every gift and every payment, shows totals for each campaign, and prepares the details you need for a receipt. It never decides an amount from what the browser says: every amount is checked again on the server.
Who uses it
- Donors fill in the donation form on your site.
- Staff and treasurers use the totals and receipt details to thank donors and keep records.
- The owner decides the amounts, currencies and campaigns on offer.
Setup
- Ask your 1vsM contact to install Donations (core) on your site.
- It installs these first, automatically: Checkout.
- Tell your 1vsM contact the currencies you accept, the smallest and largest gift you will take, the preset amounts to show, and the campaigns to offer (for example "General fund" or "Building appeal").
- Decide whether donors must pick a campaign, or whether a default campaign is used when they pick none.
- Make sure a payment method is connected in Checkout. Recurring gifts need a payment method that supports repeating payments.
- Decide who sends receipts and how. The app prepares the receipt details but does not send anything.
- Give a small test gift in test mode and confirm it appears once its payment is confirmed.
Admin tasks
Donations adds a read-only Donations tab to the admin menu for staff with the admin, commerce manager or commerce viewer role. It has no buttons that change anything.
Check your totals
- Open Donations. Campaign totals shows, for each campaign and currency, the number of paid donations and the gross, refunded and net amounts.
- Pick a campaign to see only its donations, or use the filter for One-time or Recurring.
- The list shows the donation, donor, campaign, kind, amount, state, receipt and date. Open a donation to see its payments and refunds.
Prepare a receipt
- Open a donation. The list marks it Receipt ready once a confirmed payment exists, or No receipt yet.
- The receipt details your developer can pull show the donor, amount, date and reference.
- Send it yourself through your normal, approved channel. Nothing is sent automatically.
A refund on a recurring gift
- Refunds are recorded once each against the gift and lower the net total.
Member view
The app provides the donation service behind a donation form, but it does not ship a form page of its own: your site's developer builds the form. A form built on it can offer amount choices, a campaign list if you use campaigns, an "anonymous" choice, optional name and email, and a choice between a one-time gift and a weekly, monthly or yearly gift. After choosing, donors are taken to the payment page. They do not see other donors' gifts.
Styling it to your brand
This app takes its colours, fonts and corners from the brand profile you enter once in 1vsm.com's Brand intake. That one profile applies to every app automatically, so there is nothing to set up here.
Troubleshooting
- "Unknown campaign." The campaign chosen is not on your list. Ask your 1vsM contact to add it, or pick one that is listed.
- "Choose a campaign." Your form requires a campaign and none was chosen.
- The amount is refused. Amounts must be whole cents within your minimum and maximum, in a currency you accept. Currencies without two decimals (such as the Japanese yen) are not accepted.
- A recurring gift will not start. The payment method connected for the site may not support repeating payments. Ask your 1vsM contact.
- A gift does not show in the totals. A gift only counts once its payment has been confirmed by the payment provider. A started but unpaid gift is not counted.
- Giving is paused. Payments can be switched off for the site or provider in Checkout.
FAQ
Is the amount checked? Yes, on the server every time. Preset buttons are only suggestions.
Can a donor give anonymously? Yes. They can choose to give anonymously and the record notes it.
Does it email receipts? No. It prepares the receipt details only. You decide how and when to send them.
What if the same payment notice arrives twice? It is counted once.
Can I see totals by campaign? Yes, gross, refunded and net for each campaign and currency.
What to connect
Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.