QRCode SuiteQR platform
Documentation

Stripe test mode setup

Testing the QRCode Suite checkout flow against real Stripe requires test-mode API keys, a forwarded webhook to your local server, and a Stripe-published test card. Setup takes about 10 minutes and the same workflow handles production webhook debugging.

  1. 1

    Get your Stripe test API keys

    Stripe Dashboard → Developers → API keys → Test mode toggle. Copy the publishable key (`pk_test_…`) and secret key (`sk_test_…`). Paste into `.env.local` as `STRIPE_PUBLISHABLE_KEY` and `STRIPE_SECRET_KEY`. Restart your dev server.

  2. 2

    Install and authenticate Stripe CLI

    Install via Homebrew (`brew install stripe/stripe-cli/stripe`) or download from stripe.com/docs/stripe-cli. Run `stripe login` — opens a browser confirmation. CLI is now linked to your Stripe account; future commands work in test mode by default.

  3. 3

    Forward webhooks to localhost

    In a separate terminal: `stripe listen --forward-to localhost:3000/api/webhooks/stripe`. The CLI prints a webhook signing secret (`whsec_…`); copy it to `.env.local` as `STRIPE_WEBHOOK_SECRET`. Restart the dev server again. Every Stripe event now hits your local handler.

  4. 4

    Trigger a test payment with 4242 4242 4242 4242

    Sign up on your local dev site, click upgrade to Pro, use card `4242 4242 4242 4242` with any future expiry and any 3-digit CVC. Stripe accepts the test payment, fires `checkout.session.completed`, your handler creates the License row. Verify in `pnpm db:studio`.

Frequently asked questions

What is QRCode Suite?

QRCode Suite is a standalone QR code platform: create a free account and generate branded, dynamic QR codes in the browser — no WordPress required. Connectors bring the same codes to WordPress and WooCommerce, where orders can be attributed to specific QR codes.

Does QRCode Suite work without WordPress?

Yes. QRCode Suite is a standalone SaaS — sign up, create QR codes, and track scans entirely on qrcode-suite.com. The WordPress plugin is an optional connector that brings your codes into wp-admin and adds WooCommerce order attribution.

Does QRCode Suite require a separate subscription?

The Free plan is available at no cost — no credit card required. Paid plans (Pro €9, Business €29, Agency €79 per month) unlock unlimited codes, redirect rules, and more. There is no separate per-scan fee.

What QR code types does QRCode Suite support?

QRCode Suite supports 22 QR code types: Static URL, Dynamic URL, Plain Text, Phone, Email, Location, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Social profile, PDF, File download, App download, Coupon, Calendar event, Lead capture form, Review collection, Wholesale inquiry, Loyalty reward, and Custom payload.

Can I change the destination of a QR code after printing it?

Yes. Dynamic QR codes use a short redirect URL. You can update the destination from your dashboard at any time without generating or reprinting the code.

Need help getting started?

Start free or browse all documentation.

Start freeAll docs