Donations
Take donations by PromptPay QR for several campaigns, check each slip, send numbered thank-you emails, and keep income and expense books.
Last updated 2026-11-13
Donations is for Thai temples, foundations, schools and associations. Donors pay by PromptPay QR. Your team confirms every slip; the donor then gets a numbered thank-you email. Income and expenses are kept in two books.
Turning it on
Donations needs the per-site experimental flag (ask the SeedWebs team), then Settings → General → Features → Donations. Taking money needs a paid plan (it opens about a minute after an upgrade); on a trial you can build campaigns, keep the books by hand and try a campaign in Test mode (below).
The receiving account
Donations → Settings (admins only) holds the account donors pay into:
- the bank and account number;
- the PromptPay ID — the 13-digit juristic ID is recommended. A scannable preview shows the name in your banking app;
- the bank’s e-Donation QR (upload the image), with its own on/off switch. Shown before PromptPay, only to a donor asking for a tax deduction;
- Email admins when a slip lands in the review queue.
Every change here emails all admins and needs a signed-in person (an API token gets session_required). A campaign can have its own account (admins, in the campaign editor). Until a PromptPay ID is set, the form says donations are not open yet.
Campaigns
Donations → Campaigns lists them; Add Campaign makes one: name, description and page content per language, cover image, goal, end date, status (Draft, Open, Closed), categories, amounts (presets, minimum, maximum, typed), the anonymous and tax-deduction switches, and your own fields (Forms field types, no file upload).
Donations → Categories (admins) holds them as a tree. Deleting one keeps its campaigns and moves its sub-categories up.
Each category has a public page at /donation-categories/<slug> (/th/… in Thai; View on its edit page): its description, content and image, then the Open campaigns in it or its sub-categories. Settings → General → URL → Donation campaign categories picks /donation-categories/<child> or /<parent>/<child> (the short address redirects). Template: donation-category (or donation-category-<slug>); not in the sitemap. The slug donation-categories is reserved for pages and flat posts.
Each campaign has a page at /donate/<slug> (/th/… in Thai) with its form. A draft opens only with ?preview=1 for a signed-in admin or editor (button off, no totals). After the end date (23:59 Bangkok) the form closes; slips for earlier pledges are still taken. A page of yours at donate/<slug> wins over the campaign (the editor warns). A renamed slug’s old address stops working. Template: donation-campaign; recolour it with :root{--sw-give-accent:#c71585} in your theme’s CSS.
Putting the form on any page
The campaign editor shows its Donation form tag: {{donation_form slug="<slug>"}}. Paste it anywhere {{form}} works. class="…" adds a class and submit="…" replaces the button label. Written bare, {{donation_form}} means the campaign only on its own page. An unknown slug prints nothing. In article mode it needs a page template (the default theme has one) and never shows on an article-mode Home page.
Progress and public lists
More tags work wherever the form tag does:
{{donation_progress slug="<slug>"}}— amount raised, the goal bar and the number of donations (unless Number of donations is off);{{donation_donors slug="<slug>" limit="10"}}— the latest donors, only while the campaign’s Donor list is on (amounts only with Show amounts in the donor list). anonymous donors are never named; manual income is listed only with a display name;{{donation_expenses slug="<slug>" limit="10"}}— the total spent and the latest expenses, only while Expense list is on;{{donation_campaigns}}— every Open campaign as a ready-made card;{{#each donation_campaigns category="<slug>"}}…{{/each}}— your own card design ({{item.card_attrs}}on each card); a category includes its sub-categories, and on a category page a loop withoutcategory=lists that category. In{{#each item.categories}},{{item.url}}is the category page,{{item.parent_slug}}its parent.{{donation_category_filter}}adds filter buttons for the top-level categories (a parent keeps its sub-categories’ campaigns;level="all"adds every sub-category; on a category page, its sub-categories);{{donation_stat kind="raised"}}(or"count","open") and{{donation_spending}}(by category) — the whole site’s year, unassigned income too;year="2568". Off until ticked in Donations → Settings.
Figures refresh within a minute; lists show at most 50 rows.
What the donor sees
- The form: amount, name, email, “Give anonymously” when allowed (name and email then optional; no email, no emails), “I want a tax deduction (e-Donation)” when allowed — the 13-digit tax ID, the name on it and a required tick agreeing to send both to the Revenue Department — and your own fields.
- After Donate, a private status page with a reference like
DN-20261101-7KQ2, the amount and the QR: PromptPay with the amount filled in, or, for a tax donor when your e-Donation QR is switched on, that QR first (the donor types the amount). - An email with the reference and a link back to that page (not a receipt; at most 3 to one address a day, counted in your daily email limit). The page has Copy link.
- The donor pays, then uploads the slip there: JPEG, PNG, GIF or WebP up to 4 MB (an iPhone photo is converted first), at most 3 per donation.
- The page reads “We are checking your slip with the bank…”, then “Slip received — our staff are checking it”, and later “Donation received — thank you!” with the receipt number (“Checked with the bank.” when the check itself confirmed it). It never shows the donor’s name, email, tax ID or slip. A voided donation reads “This pledge is closed — please contact” your site.
Confirming donations
Each slip is checked with the bank through EasySlip (300 checks a month on Pro, 500 on Business, 3 a donation; none on a trial). For now a person confirms every checked slip; the drawer shows what the bank read. If a check could not run, an admin can press Check with the bank again. Waiting donations show as a red badge on Income and in Overview’s Review queue. Donations → Settings lists which accounts are checked and has the review box: with it ticked, admins get at most one email an hour.
Review opens a drawer with the pledge, its QR, the account in force then, the answers and every slip. To Confirm donation, enter what the bank received (a different amount is flagged), the date, and the bank reference — or a note on how you checked. Tick Paid via the e-Donation QR when the slip shows it; on a tax pledge, tick that the slip’s sender is the taxpayer. A bank reference confirms one donation only (unless that one was voided or is gone). Void, with a reason, a pledge never paid.
On Income, a pledge still awaiting its slip can be confirmed once the money is on your statement; Details opens any form donation read-only. Only admins confirm or void, and confirming needs them signed in, not an API token.
The thank-you email
Confirming emails the donor a thank-you numbered like 2569-00001 (per site and Buddhist-era year, in order, never reused): Settings → Emails email-donation-receipt, tags {{site_name}}, {{donor_name}}, {{amount}}, {{campaign_name}}, {{receipt_no}}, {{received_date}}, {{ref}}; outside the email limit. The donor’s page then has View receipt, a printable page (template donation-receipt-page; your details in Donations → Settings). Neither is a tax receipt.
Test mode
To try a campaign’s whole flow without moving money, turn on Test mode under its status in the campaign editor (editors and admins) and save. While it is on, every visitor’s donation to that campaign is a test and nobody can give to it for real; the site’s other campaigns are not affected. The editor shows an amber banner, Campaigns a Test badge, and Overview names every campaign in test mode.
- The form and the status page say “Test mode — do not transfer money”, and the QR is a sample no bank app can pay. It works on a trial plan and before a PromptPay ID is set.
- Any picture uploaded as the slip confirms the donation at once, with no bank check, numbered
TEST-2569-00001— never a number from the real sequence. Both emails’ subjects start with “[ทดสอบ]” (“test”), and the receipt page says it is a test receipt, not valid for a tax deduction. - Test donations never count: not in the totals, the public figures and lists, the review queue, the CSV or the e-Donation export. Income lists them with a Test badge.
- A draft in test mode shows in its Preview with the test bar, but its form cannot be sent from there. To try the whole flow, set it Open with test mode on: every donation to it is then a test.
- Switching back to Live keeps the test donations (a test pledge stays a test, even when its slip comes later). Delete this campaign’s test donations (admins) removes them with their slips and files, and the next test number is
…00001again. Deleting a campaign deletes its test donations with it.
Members’ donation history
GET /api/member/donations (member token; your theme builds the page, as for orders) lists a member’s pledges made signed in plus guest pledges with their email — never voided ones, tax IDs or slips; confirmed ones carry a 15-minute receipt link. A test donation carries is_test: true, for the theme to badge. Set window.swMemberToken (or a function returning it) so the form knows who is giving.
Books and Overview
Overview shows income, expenses and balance for a period, the review queue, a table per campaign with % of goal, a 12-month chart and Export CSV (never tax IDs). Income and Expenses take manual entries with private attachments; amounts, dates and bank references are locked once saved. Mistakes are voided, never deleted. Totals count received money only, manual income included.
The e-Donation export
Overview → e-Donation export (admins) lists confirmed tax-deduction donations by month and campaign, except e-Donation QR gifts (the bank reported those). Download CSV has the full 13-digit IDs for the Revenue Department system. Once keyed, click I have keyed these into RD: those rows leave the next export unless you tick Include rows already keyed into RD.
Roles and privacy
Writers see nothing. Editors read everything, edit campaign text and export the CSV. Admins do the rest. Tax IDs are shown masked to everyone; in the review drawer an admin can click Show full number, which records who looked. The full ID and the e-Donation export need an admin signed in, not an API token.
The personal details of a pledge still unpaid 90 days later are cleared (the reference and amount stay); backups keep them until restored. Slip images are kept a year.
A Backup restore that would undo donation entries asks you to confirm, and used bank references and receipt numbers are never reopened. A Demos import asks too, and keeps the books. Reset empties the books but keeps the used references and the receipt counter.
Not yet
Recurring giving and card payments — see What SeedWebs does not have.