Skip to Content
FluxStore is currently invite-only. Some sections of this documentation are still being written and expanded.
PaymentsStripe Setup

Stripe Setup

Stripe is FluxStore’s primary payment processor. It handles credit cards, debit cards, Apple Pay, Google Pay, and dozens of other payment methods. Your server never touches sensitive card data.

FluxStore offers two ways to connect Stripe: Stripe Connect (recommended) and manual API keys. Both give you the same checkout experience, but they differ in how FluxStore interacts with your Stripe account.

Stripe Connect links your Stripe account to FluxStore’s platform account using OAuth. This is the easiest way to get set up and is what we recommend for most stores.

Go to Dashboard > Payment Gateways and click Connect with Stripe. You’ll be redirected to Stripe to authorize FluxStore, then sent back to your dashboard automatically. No keys to copy, no webhooks to configure.

What FluxStore can and can’t do with Connect

When you connect via Stripe Connect, you’re giving FluxStore permission to create checkout sessions and view payment data related to your store’s orders. This is how we show you order status, payment confirmations, and dispute notifications in your dashboard.

What FluxStore can do:

  • Create checkout sessions for your customers
  • View payment and order data related to FluxStore purchases
  • Display your account status (charges enabled, payouts enabled)

What FluxStore cannot do:

  • See any Stripe activity unrelated to FluxStore
  • Access your full Stripe dashboard
  • Transfer money or change your payout settings
  • Take a platform fee from your transactions

Why we prefer Connect

Being able to see payment data for your FluxStore orders means we can help you debug issues faster. If a customer says their payment went through but their order didn’t deliver, we can look up exactly what happened on the Stripe side without needing you to dig through your own Stripe dashboard and send us screenshots.

You can disconnect at any time from your dashboard, which immediately revokes FluxStore’s access.

If you’re not comfortable with Connect

We understand that some store owners would rather not link their Stripe account to a third party platform. That’s completely fine. If you use manual API keys instead, we don’t get any access to your Stripe account beyond what the webhooks tell us. The trade off is that setup takes a bit more work, and if something goes wrong with a payment, we’ll have less visibility to help you troubleshoot.

Manual API keys

If you prefer full control over your Stripe integration, you can enter your API keys directly instead of using Connect.

Step 1: Get your API keys

  1. Log into the Stripe Dashboard 
  2. Copy your Publishable Key (starts with pk_live_ or pk_test_)
  3. Copy your Secret Key (starts with sk_live_ or sk_test_)
  4. In FluxStore, go to Dashboard > Payment Gateways, click Enter API Keys Manually, and paste both keys

Keep your Stripe secret key confidential. Never share it publicly or commit it to version control. If compromised, rotate it immediately in the Stripe Dashboard.

Step 2: Set up your webhook

FluxStore needs to receive events from Stripe to know when payments succeed, subscriptions renew, and disputes are filed. You’ll need to create a webhook endpoint in your Stripe account.

  1. Go to Stripe Dashboard > Developers > Webhooks 
  2. Click Add endpoint
  3. Set the endpoint URL to: https://api.fluxstore.net/api/webhooks/stripe
  4. Select the following events:
EventWhat it’s for
checkout.session.completedPayment completed (one-time and subscription)
payment_intent.succeededPayment confirmed
payment_intent.payment_failedPayment failed
charge.succeededCharge confirmed
charge.dispute.createdChargeback filed
charge.dispute.updatedDispute status changed
charge.dispute.closedDispute resolved
customer.subscription.createdSubscription started
customer.subscription.updatedSubscription modified
customer.subscription.deletedSubscription cancelled
invoice.paidSubscription invoice paid
invoice.payment_failedSubscription invoice failed
  1. Click Add endpoint to save
  2. On the webhook detail page, reveal and copy the Signing Secret (starts with whsec_)
  3. Back in FluxStore, update your gateway settings and paste the webhook secret

The webhook secret is required. Without it, FluxStore can’t verify that incoming webhooks are genuinely from Stripe, and your gateway will not process payments.

Step 3: Verify it works

Place a test order using Stripe’s test card numbers  (e.g. 4242 4242 4242 4242 for a successful payment). Check that the order appears in your FluxStore dashboard as paid. If it stays pending, your webhook is likely not reaching FluxStore. Check the webhook logs in your Stripe dashboard for failed delivery attempts.

After connecting

Whichever method you chose, check the Payment Gateways page to confirm that charges and payouts are both enabled. If either is disabled, your Stripe account likely needs additional verification. Stripe requires identity documents and business details before you can receive payouts.

Stripe will still process payments before verification is complete, but funds won’t transfer to your bank account. Complete onboarding at dashboard.stripe.com/account/onboarding  to start receiving payouts.

Test mode vs live mode

Before accepting real payments, test your entire checkout flow using Stripe’s test mode. With Connect, connect a Stripe account that’s in test mode. With API keys, use your test keys (starting with sk_test_ and pk_test_).

In test mode, use Stripe’s test card numbers  to simulate successful payments, declines, and disputes. Switch to live credentials once you’re confident everything works.

Disconnecting

To disconnect Stripe, go to Dashboard > Payment Gateways and click Disconnect. If you used Stripe Connect, this immediately revokes FluxStore’s access to your account. Existing orders are preserved, but active subscriptions will fail to renew at their next billing cycle unless you reconnect.

Supported currencies

Stripe supports over 135 currencies depending on your account’s country. For the full list, see Stripe’s supported currencies . If you have multi currency checkout enabled, see Currencies for how this interacts with FluxStore.

Next steps

TroubleshootingPayPal Setup