Stripe Checkout Setup - softerfish/fyuhls GitHub Wiki
This guide walks through the current Stripe setup flow in fyuhls.
Go to:
- Admin -> Config Hub -> Monetization
In the Payment Gateways section, Stripe uses:
- Enable Stripe Checkout
- Secret Key
- Webhook Secret
Stripe checkout is only considered ready when:
- Enable Stripe Checkout is turned on
- a valid Secret Key is saved
The Webhook Secret is strongly recommended for webhook verification and is part of a complete production setup.
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.
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
Turn on:
- Enable Stripe Checkout
Then save Config Hub.
At that point, checkout can start using Stripe if the secret key is valid.
Stripe success redirects already work through the direct success-confirmation route, but webhook verification is still important for safer event handling.
Point Stripe to:
/payment/callback/stripe
using your site domain, for example:
https://yourdomain.com/payment/callback/stripe
Stripe gives you a webhook signing secret that usually looks like:
whsec_...
Paste that into:
- Webhook Secret
Then save again.
Before going live, test:
- a successful checkout
- a cancelled checkout
- the success return back into fyuhls
- 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.
Usually caused by:
- Enable Stripe Checkout is off, or
- the Secret Key is missing
Usually caused by:
- wrong callback URL
- wrong environment
- missing or incorrect Webhook Secret
Make sure your Stripe secret key and webhook configuration both belong to the same environment:
- test with test
- live with live
- 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.