Skip to main content
Stripe is the default payment gateway for global businesses on Fluxrate. When connected, Fluxrate creates a Stripe Payment Link every time an invoice is finalized. Your customers receive an email with a one-click payment link — no checkout integration needed on your end.

​
Prerequisites

  • A Stripe account (live or test mode)
  • A Stripe Secret Key (sk_live_... or sk_test_...)
  • A Stripe Webhook Signing Secret (whsec_...)

​
Setup

​
Step 1 — Get your Stripe API Key

  1. Go to Stripe Dashboard → Developers → API Keys.
  2. Copy your Secret key (sk_live_...).
Never expose your secret key in client-side code. Fluxrate stores it encrypted — you only need to paste it once.

​
Step 2 — Connect in Fluxrate

  1. Open Dashboard → Integrations.
  2. Click Connect next to Stripe.
  3. Fill in the form:
  1. Click Create Connection. Fluxrate generates a unique Webhook URL for your integration.

​
Step 3 — Configure the Webhook in Stripe

  1. Go to Stripe Dashboard → Developers → Webhooks.
  2. Click Add endpoint.
  3. Paste the Webhook URL from Fluxrate (shown after connecting):
  4. Under Events to send, select:
    • checkout.session.completed
    • payment_intent.succeeded
    • payment_intent.payment_failed
    • invoice.payment_succeeded
    • invoice.payment_failed
  5. Click Add endpoint.
  6. Copy the Signing secret (whsec_...) shown on the webhook details page.

​
Step 4 — Save the Webhook Secret

  1. Back in Fluxrate, go to Dashboard → Integrations → Manage (Stripe).
  2. Paste the signing secret into the Webhook Secret field.
  3. Click Save Changes.
Your Stripe integration is now fully configured.

​
How Payments Work

Fluxrate passes invoice_id and customer_id in the Stripe Payment Link metadata. When Stripe fires a webhook on payment completion, Fluxrate reads these values from data.object.metadata to identify the invoice and marks it as PAID.

​
Webhook Payload Handling

Fluxrate reads the following fields from Stripe webhook payloads: Events that trigger invoice payment:
  • checkout.session.completed
  • payment_intent.succeeded

​
Managing the Integration

​
Troubleshooting

The Stripe-Signature header didn’t match your stored webhook secret. Make sure you copied the Signing secret from Stripe (starts with whsec_), not the endpoint URL. Re-save the secret in Fluxrate and ensure Stripe is sending to the exact URL shown.
Check that your Payment Link was created with invoice_id in the metadata. Also confirm that the webhook event (checkout.session.completed or payment_intent.succeeded) is in your subscribed events list in Stripe Dashboard.
Verify the webhook URL in Stripe Dashboard matches the one shown in Fluxrate exactly. Check Dashboard → Integrations → Webhook Events in Fluxrate to see all received events and their statuses.