Stripe Setup
Connect Stripe to accept real payments.
fellos uses Stripe for all payments — store purchases, event tickets, everything. Money goes directly to your organization's Stripe account, not through fellos. You'll need a Stripe account first; create one free at stripe.com.
Test Mode vs. Live Mode
Stripe has two sets of keys: test (nothing is real, use fake card numbers to try everything end-to-end) and live (real money). You configure both in fellos and switch between them with the Mode selector at the top of the page.
Set up test keys first. Verify checkout works end-to-end with a fake card (e.g., 4242 4242 4242 4242). Then add your live keys and flip the mode to Live.
Finding Your Stripe Keys
- Log into dashboard.stripe.com.
- Toggle between Test/Live in the top-right as needed.
- Go to Developers → API keys.
- Copy the Publishable key (starts with
pk_) and Secret key (starts withsk_). You'll need both. - In fellos, go to Admin → Integrations → Payments. (The page header reads "Payment Settings" — this is where you connect Stripe.) Paste your keys into the appropriate Test Keys or Live Keys section.
Set Up the Webhook
Stripe needs to tell fellos when a payment succeeds or fails. This happens through a webhook — an HTTP endpoint that Stripe posts to.
- In fellos, the Payments page shows a Webhook URL. Copy it.
- In Stripe, go to Developers → Webhooks and click Add endpoint.
- Paste your fellos webhook URL.
- Add these events:
checkout.session.completedpayment_intent.payment_failed
- Save the endpoint. Stripe shows you a Signing secret (starts with
whsec_). - Copy that secret and paste it back into the fellos Payments page.
- Save.
Verify Everything Works
In test mode, check that:
- Turn on the store (Store page).
- As a member, add an item to the cart and check out using a test card (
4242 4242 4242 4242, any future date, any CVC). - Checkout completes, you see the confirmation page.
- The order shows up in the Comptroller's Orders tab as Processing (meaning payment cleared).
If the order stays stuck on Pending, the webhook isn't firing or isn't verified. Check that the webhook URL in Stripe exactly matches what fellos shows, and that you've pasted the signing secret correctly.
Flipping to Live
Once test mode works:
- Get your live keys and webhook secret from Stripe (the process is identical, just in live mode).
- Paste them into the Live Keys section in fellos.
- Change Mode from Test to Live.
- Save. Real charges can now happen.
Even if you're confident, always run at least one full end-to-end checkout in test mode first. It catches config mistakes before real members hit them.