Stripe Checkout Setup - softerfish/fyuhls GitHub Wiki

Stripe Checkout Setup

This guide walks through the current Stripe setup flow in fyuhls.

Where to configure it

Go to:

  • Admin -> Config Hub -> Monetization

In the Payment Gateways section, Stripe uses:

  • Enable Stripe Checkout
  • Secret Key
  • Webhook Secret

What fyuhls currently needs

Stripe checkout is only considered ready when:

  1. Enable Stripe Checkout is turned on
  2. a valid Secret Key is saved

The Webhook Secret is strongly recommended for webhook verification and is part of a complete production setup.

Step-by-step setup

1. Create or open your Stripe account

Log into your Stripe dashboard and decide whether you are setting up:

  • test mode first, or
  • live mode

Start with test mode unless you are replacing an already-working live gateway.

2. Find your Stripe secret key

In Stripe, copy the secret key for the environment you are using.

It usually looks like:

  • sk_test_... for test mode
  • sk_live_... for live mode

Paste that into:

  • Secret Key

3. Enable Stripe checkout in fyuhls

Turn on:

  • Enable Stripe Checkout

Then save Config Hub.

At that point, checkout can start using Stripe if the secret key is valid.

Webhook setup

Stripe success redirects already work through the direct success-confirmation route, but webhook verification is still important for safer event handling.

4. Create a webhook endpoint in Stripe

Point Stripe to:

  • /payment/callback/stripe

using your site domain, for example:

  • https://yourdomain.com/payment/callback/stripe

5. Copy the webhook signing secret

Stripe gives you a webhook signing secret that usually looks like:

  • whsec_...

Paste that into:

  • Webhook Secret

Then save again.

Testing checklist

Before going live, test:

  1. a successful checkout
  2. a cancelled checkout
  3. the success return back into fyuhls
  4. subscription/package activation on the user account

If you use rewards with premium-sale logic, also test a later failure or reversal path in your broader payment workflow.

Common mistakes

Stripe is enabled but checkout still does not appear

Usually caused by:

  • Enable Stripe Checkout is off, or
  • the Secret Key is missing

Webhook problems

Usually caused by:

  • wrong callback URL
  • wrong environment
  • missing or incorrect Webhook Secret

Using the wrong environment

Make sure your Stripe secret key and webhook configuration both belong to the same environment:

  • test with test
  • live with live

Notes for operators

  • The package checkout page only offers Stripe when it is actually ready.
  • fyuhls creates a pending internal transaction before redirecting the user to Stripe.
  • Stripe success returns through /payment/stripe/success.

Related pages

⚠️ **GitHub.com Fallback** ⚠️