Stripe
Billing
Subscription ManagementStripe Connection Guide
StewardAccess:Super Admin
This guide walks you through connecting your Stripe account to SanctuaryOS for online giving. Stripe handles all payment processing, with funds deposited directly into your church's bank account.
Prerequisites
- A Stripe account (create one free at stripe.com if you do not have one)
- Your church's bank account linked in Stripe for payouts
- SUPER_ADMIN role in SanctuaryOS
Step 1: Initiate Connection
- Navigate to Settings → Integrations
- Click Connect with Stripe on the Stripe card
- You will be redirected to Stripe's authorization page
Step 2: Authorize SanctuaryOS
- Log in to your Stripe account (or create a new one)
- Review the permissions SanctuaryOS is requesting
- Click Authorize to grant access
- You will be redirected back to SanctuaryOS
Step 3: Verify Connection
- The Stripe card should now show “Connected” with a green badge
- Your truncated account ID is displayed for reference
- Click Dashboard to verify in Stripe
What Happens After Connection
- A branded giving page is automatically available at your church's URL
- Funds marked as “Visible Online” appear on the giving page
- Online donations flow into SanctuaryOS as transactions
- Transactions are automatically attributed to the correct service window
- Recurring giving schedules are managed through Stripe
Supported Payment Methods
| Field | Type | Description |
|---|---|---|
| Credit / Debit Cards | Card | Visa, Mastercard, Amex. Standard Stripe processing fees apply. |
| Apple Pay | Digital wallet | Available on Safari and iOS devices when enabled in your Stripe account. |
| Google Pay | Digital wallet | Available on Chrome and Android devices when enabled in your Stripe account. |
| Interac | Canadian debit | Canadian Interac debit payments where supported by Stripe in your region. |
| Recurring Donations | Subscription | Donors can set up weekly, bi-weekly, or monthly recurring gifts. |
Disconnecting
- Navigate to Settings → Integrations
- Click Disconnect on the Stripe card
- Confirm the disconnection
- Online giving is immediately disabled
- Existing transaction records are retained
Troubleshooting
Connection fails or times out
Ensure pop-ups are not blocked for the SanctuaryOS domain. The Stripe OAuth flow opens in the same window and must redirect back to complete.
Status shows “Not connected” after authorizing
The callback URL may have been intercepted. Try the connection again. If the issue persists, check that your Stripe account is in good standing.
Online giving page shows no funds
Ensure at least one fund has the “Visible Online” toggle enabled in Settings → Finance → Funds.