Back to fellos.app

Stripe Setup

Connect Stripe to accept real payments.

The Payment Settings page, ready for Stripe keys.
The Payment Settings page, ready for Stripe keys.

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.

Recommended flow

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

  1. Log into dashboard.stripe.com.
  2. Toggle between Test/Live in the top-right as needed.
  3. Go to Developers → API keys.
  4. Copy the Publishable key (starts with pk_) and Secret key (starts with sk_). You'll need both.
  5. 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.

  1. In fellos, the Payments page shows a Webhook URL. Copy it.
  2. In Stripe, go to Developers → Webhooks and click Add endpoint.
  3. Paste your fellos webhook URL.
  4. Add these events:
    • checkout.session.completed
    • payment_intent.payment_failed
  5. Save the endpoint. Stripe shows you a Signing secret (starts with whsec_).
  6. Copy that secret and paste it back into the fellos Payments page.
  7. 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:

  1. Get your live keys and webhook secret from Stripe (the process is identical, just in live mode).
  2. Paste them into the Live Keys section in fellos.
  3. Change Mode from Test to Live.
  4. Save. Real charges can now happen.
Don't skip test mode

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.