Online donations and how they become receipts¶
In short: When a donor pays on one of your Credit Card forms, ActiveDonor finds the donor by email (or creates them) and creates the receipt for you, usually within a minute. No manual capture is needed. To check a payment, open /online-donations in your ActiveDonor account: each payment is listed as Pending, Complete, Failed or Abandoned, with a link to its receipt.
Overview¶
An online donation is a card payment made through a donation form on your Donate page, your website embed, or a form's direct link. The money goes to your PayFast or Paystack account. ActiveDonor is notified by the payment provider and turns the payment into a normal receipt, so it counts in your reports, project totals and Section 18A certificates like any other donation.
Before you start¶
You'll need:
- An active Credit Card donation form with a verified payment account (see Creating donation forms and Connecting a payment account (PayFast, Paystack, Paysoft)).
- The Manage Receipts permission to view the Online Donations page.
What the donor does¶
- Opens your form and picks or types an amount (minimum R5).
- Enters their name and email, and optionally their phone number.
- Optionally ticks I need a Section 18A tax certificate and adds their address, ID or passport number and tax number.
- Optionally ticks the marketing consent box.
- Clicks your button, pays on the PayFast (or Paystack) page, and returns to your thank-you page.
How the receipt is created¶
Once the payment provider confirms the payment, ActiveDonor:
- Finds the donor by email address. If no donor has that email, a new donor is created. If two donors share the email, the payment goes to the one who gave most recently. Matching is by email only, never by name or phone.
- Fills in missing donor details from the form. Details you already have on file are never overwritten. Differences are noted in the donor's activity log for you to review.
- Creates the receipt with:
- the amount paid and the payment date;
- the form's Receipt method (or Online Donation if none is set) and Receipt type;
- an allocation to the project the donor chose;
- the PayFast or Paystack payment reference in Payment Reference.
- Emails the receipt to the donor if automatic sending is on in your receipt settings, or if the form has Email the donor their receipt automatically ticked.
If the donor ticked marketing consent, that opt-in is recorded in the donor's activity log.
Section 18A on online donations¶
The receipt is marked for Section 18A only if the donor asked for a certificate and the donor now has complete tax details (ID or registration number and address). If they asked but details are missing, the receipt is created as a normal receipt and a note is added to the donor's activity log. Request the missing details from the donor (see Requesting updated information from a donor), then switch the receipt's Section 18A option on.
ActiveDonor does not issue certificates automatically for online donations. Issue them from Section 18A as usual (see Issuing a single Section 18A certificate).
The Online Donations page¶
The Online Donations page lists every online payment attempt, newest first, 30 per page. There is no menu link to it yet: type /online-donations after your ActiveDonor address (for example https://youraccount.ad.org.za/online-donations).
| Column | What it shows |
|---|---|
| Date | When the donor started the payment. |
| Donor | Name and email typed on the form. |
| Amount | The amount in rand. |
| Status | See the table below. |
| Reference | The provider and its payment ID, for example payfast:123456. |
| Receipt | A link to the receipt, once created. |
Use the Status filter on the left to show one status at a time.
What each status means¶
| Status | Meaning | Receipt? |
|---|---|---|
| 🟡 Pending | The donor started paying but the provider hasn't confirmed it yet. Most move on within minutes. | Not yet |
| 🟢 Complete | The provider confirmed the payment. | Yes, linked in Receipt |
| 🔴 Failed | The payment was declined or cancelled, or the provider couldn't be reached. Nothing was charged. | No |
| ⚪ Abandoned | The provider later confirmed the payment was cancelled or failed. | No |
| 🔴 Needs review (extra label) | ActiveDonor couldn't confirm the payment after 48 hours, or the provider reported a different amount. Hover over it to see the reason. | Check in your provider dashboard |
ActiveDonor checks every night for payments that are complete but have no receipt yet, and tries again. It also flags payments still Pending after 48 hours with Needs review.
Monthly card donations¶
If the donor turned on Give monthly instead on a PayFast form, the first payment is receipted here like any other. ActiveDonor also creates a recurring donation under Receipts > Recurring, and each later monthly payment is receipted automatically at the amount PayFast actually collected. See Recurring donations.
What this does not do¶
- It does not process refunds. Refund the donor in PayFast or Paystack, then void the receipt in ActiveDonor.
- It does not merge duplicate donors. If a donor gives with a different email, a new donor may be created; merge them afterwards (see Merging duplicate donors).
- It does not issue Section 18A certificates automatically.
Common issues & solutions¶
| What you see | What it means | How to fix it |
|---|---|---|
| A Complete donation with no receipt link. | The receipt is still being created, or creating it failed. | Wait a few minutes and refresh. ActiveDonor retries automatically and again overnight. If it's still missing the next day, contact support with the Reference. |
| A donation stuck on Pending. | The provider hasn't sent its payment notice. | Check the payment in your PayFast or Paystack dashboard. If it was paid, contact support with the Reference. |
| Needs review: "Unconfirmed after 48 hours; check the provider dashboard and mark manually." | ActiveDonor never received confirmation. | Look up the payment in your provider dashboard. If it was paid and no receipt exists, capture the receipt manually. |
| Needs review: "Provider reports a different amount/currency; review in the provider dashboard." | The amount paid doesn't match the form amount. | Check the payment in your provider dashboard and capture the correct receipt manually. |
| The receipt has no project allocation. | The form had no project the payment could be allocated to. | Edit the receipt and add an allocation (see Allocating receipts to projects). The donor's activity log notes which receipt needs it. |
| Donors see "We could not reach the payment provider. Nothing was charged — please try again in a moment." | The provider was unavailable when they clicked pay. | Ask the donor to try again. The attempt shows as Failed. |
FAQ¶
Do I have to capture online donations as receipts myself? No. Every confirmed payment becomes a receipt automatically.
How quickly does the receipt appear? Usually within a minute of the donor paying. See Why didn't my online donation create a receipt? if it doesn't.
Which date is on the receipt? The date the payment was confirmed.
Why did the donation go to a new donor instead of my existing one? ActiveDonor matches on email only. If the donor used an email you don't have on file, a new donor is created. Merge the two afterwards.
Do sandbox (test) payments create receipts? Yes. Void them when you've finished testing.