Stripe Test Mode Setup - softerfish/fyuhls GitHub Wiki

Stripe Test Mode Setup

This page is the short, testing-first version of the Stripe setup flow in fyuhls.

Use it when you want to get Stripe test payments working before you switch to live mode.

Where to configure it in fyuhls

Go to:

  • Admin -> Config Hub -> Monetization

In Payment Gateways, Stripe uses:

  • Enable Stripe Checkout
  • Secret Key
  • Webhook Secret

What "ready" means

Stripe is only treated as ready when:

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

The Webhook Secret is strongly recommended and is part of a complete test-to-live setup.

Where to get the test Secret Key

  1. Open the Stripe dashboard
  2. Turn on Test mode
  3. Go to the API keys area
  4. Copy the test secret key:
    • sk_test_...

Paste that into fyuhls:

  • Secret Key

Turn Stripe on in fyuhls

Turn on:

  • Enable Stripe Checkout

Save Config Hub.

Where to get the test Webhook Secret

  1. In Stripe test mode, create a webhook endpoint
  2. Point it to:
    • https://yourdomain.com/payment/callback/stripe
  3. After creating it, Stripe gives you a signing secret
  4. Copy the value that looks like:
    • whsec_...
  5. Paste that into:
    • Webhook Secret

The key point is to stay in test mode while creating both the API key and the webhook.

What to test

After saving the test credentials:

  1. open a paid package in fyuhls
  2. start checkout with Stripe
  3. complete a test payment
  4. return to fyuhls
  5. confirm the package was applied

Also test:

  • canceling before payment completes
  • one webhook-driven status change in your broader payment testing

Common test-mode mistakes

Stripe is enabled but does not appear on checkout

Usually one of these is true:

  • Enable Stripe Checkout is off
  • Secret Key is blank
  • the saved key is not a valid test secret key

Webhook verification problems

Usually caused by:

  • webhook was created in live mode instead of test mode
  • wrong callback URL
  • missing or wrong Webhook Secret

Wrong environment mix

Make sure all three belong to the same environment:

  • Stripe test dashboard mode
  • sk_test_... secret key
  • test-mode webhook and whsec_... secret

Related pages

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