Online Giving Setup
Getting Started
IntroductionStart a ChurchInitial SetupChurch ProfileCampusesLogoModulesSystem ConfigurationUsers & Roles
OverviewCreating UsersRole MatrixFlock Leader ScopesCustom FieldsConnect CardFirst-Time VisitorsPrivacy RequestsFinance Settings
OverviewFundsFiscal YearOnline Giving SetupStatement ConfigPayment MethodsBank AccountsSecurity
OverviewActivity Log
Activity LogStart Fresh
Start FreshOnline Giving Setup
StewardOnline giving is powered by Stripe and enables your church to accept donations by card (with Apple Pay and Google Pay where the donor's device offers them) and, when you turn it on, by Canadian pre-authorized bank debit (PAD). The public giving page takes one-time gifts, and recurring gifts too when your church turns them on (below). This page covers the Stripe connection setup within Finance settings.
Getting Here
Navigation: Settings → Finance → Online Giving
You can also access Stripe configuration from Settings → Integrations.
Overview
SanctuaryOS uses Stripe Connect to link your church's Stripe account. Once connected, a branded giving page is automatically generated at your church's subdomain. Online donations flow into SanctuaryOS as transactions, automatically attributed to the correct service window based on when they are received.
Connecting Stripe
- Navigate to Settings → Finance → Online Giving (or Settings → Integrations)
- Click Connect with Stripe
- You will be redirected to Stripe's OAuth flow
- Log in to your existing Stripe account or create a new one
- Authorize SanctuaryOS to access your account
- You will be redirected back to SanctuaryOS with a “Connected” status
Connection Status
| Field | Type | Description |
|---|---|---|
| Status | Badge | Shows "Connected" (green) when Stripe is linked, or "Not connected" (gray) when no account is linked. |
| Account ID | Display | The first 8 characters of your Stripe account ID, shown after connection for reference. |
| Dashboard Link | Button | Opens the Stripe Dashboard in a new tab to manage your account, view payouts, and handle disputes. |
Supported Payment Methods
- Credit / Debit cards: Visa, Mastercard, Amex
- Apple Pay and Google Pay: shown in the card form by Stripe when the donor's device and browser support them and they are on in your Stripe account
- Bank account (PAD): Canadian pre-authorized debit, only when you turn it on (below)
Interac debit and Interac e-Transfer are not taken online. An e-Transfer your church receives is entered in a Session like any other gift.
Service Window Attribution
Online donations are automatically assigned to a service window based on the service pattern configuration. Each service pattern defines a time window (hours before and after the service time) during which incoming online gifts are attributed to that service.
Bank Debit (PAD)
Settings → Integrations → Offer bank debit (PAD) on the giving page is off by default. Turn it on and a donor can choose Bank account (PAD) instead of a card, for a one-time gift or a recurring one. The page offers it only when your Stripe account can take Canadian pre-authorized debits: turn on ACSS Debit in Stripe (Settings → Payment methods). Until then the setting tells you, and the page takes cards only.
- The PAD agreement is shown, recorded and emailed to the donor by Stripe. Leave Stripe's own mandate and debit notification emails on.
- A gift is recorded only when the bank pays. A debit takes up to 5 business days. The donor's page says the gift is pending, and nothing is booked until the bank pays; then the gift is recorded for the amount received, in the online Session of the day the bank paid, as ACH / PAD. A debit the bank refuses records nothing.
- A debit reversed later (the donor's bank claims it back) arrives as a lost dispute and books a negative Refund line, dated on the gift, like a card refund.
- The “cover the fee” option is not offered for a bank debit.
Recurring Gifts
Settings → Integrations → Offer recurring gifts on the giving page is off by default, and then the page offers one-time gifts only. Turn it on and a donor can also choose weekly, every two weeks or monthly. Stripe must be connected first: until then the page offers no recurring option. Turning the setting off again only removes the choice from the page; gifts already set up keep going until they are stopped.
- Who charges the card: Stripe, on your church's own Stripe account, on the schedule the donor chose. The first charge is made when the donor gives.
- Each successful charge is one online gift, for the amount Stripe actually collected, in that day's online Session, on the fund the donor chose. It lands on a donor record by the same rule as a one-time gift (email and name must both match), and goes on the donor's year-end receipt like any other online gift.
- A failed charge books nothing. The schedule shows Failed with the card issuer's reason on Steward → Recurring Giving and on the donor's Recurring tab. Stripe retries on its own, and a charge that later goes through clears it. If the very first charge fails, nothing is set up.
- The donor manages it themselves: the email they get when the gift starts has a link to change the amount (from the next charge) or stop the gift. The link works for 14 days; from an expired link the donor types their email and, if a recurring gift uses that address, a new link is sent.
- A refund or a lost dispute on a recurring charge is booked like any other online gift's (below).
Refunds and Disputes
When a gift is refunded in Stripe, or a card dispute on it is lost, SanctuaryOS books a negative Refund line against the gift automatically. Nobody enters refunds by hand. Treasurers follow them on Steward → Online Giving → Refunds & disputes.
This relies on the SanctuaryOS Stripe Connect webhook, which is set up once for the whole platform by your SanctuaryOS administrator, not per church. In the Stripe Dashboard, under Developers → Webhooks, the existing Connect endpoint must receive these events, in addition to the ones it already has:
charge.refundedcharge.dispute.createdcharge.dispute.closedinvoice.paid,invoice.payment_failedandcustomer.subscription.deleted, for recurring giftspayment_intent.succeededandpayment_intent.payment_failed, for one-time bank debits (PAD) and paid event registrations
The endpoint keeps its existing signing secret, so nothing else changes. To check it works, make one small real gift, refund it in Stripe, and confirm a Refund line appears in the gift ledger.
Stripe signs every event. An event whose signature doesn't check out is refused and nothing is written. Stripe retries an event SanctuaryOS couldn't handle, and an event that arrives twice is booked only once.
Disconnecting Stripe
- Click Disconnect next to the Stripe status
- Confirm the disconnection in the dialog
- Online giving will be disabled until a new account is connected