KoolayDocumentation
⌘K
koolay.com →

Payment settings

Heads up — this page moved. Payment configuration now lives inside Site Settings under the Payment tab. The old standalone Payment Gateway sidebar entry was retired on 2026-05-14 to consolidate all site-level config in one place.

Quick start

Open the admin panel and navigate to Settings → Site Settings → Payment.

You will see two cards:

  1. Donation frequency options — checkboxes for One-time, Monthly, Yearly. Unchecked options disappear from public donation forms.
  2. Processing method — currently active payment pipeline. Two possible modes:

- Stripe Connect (Koolay-facilitated) — default for new tenants. Donations route through Koolay's Stripe Connect platform account; payouts go to your nonprofit's bank via an Express sub-account. No API keys to manage. The Stripe Connect onboarding wizard is embedded right in the tab. - Legacy BYOK — for tenants who supplied their own Stripe + PayPal credentials. The full credentials form is hidden by default; click Advanced — Edit my own keys to reveal it.

For the full walkthrough — including how to choose between modes, what Stripe asks for during onboarding, and how to migrate — see the Payment section of the Site Settings guide.

Why we changed this

The old Payment Gateway sidebar entry only contained one card (Stripe Connect onboarding) and the BYOK credentials form was scattered under Site Settings → Payment. Putting both in the same tab makes the "which mode am I on?" question answerable at a glance, and lets us hide the BYOK form once tenants migrate to Connect.