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:
FieldValue
Connection NameA friendly label, e.g. Production Stripe
Secret KeyYour Stripe secret key (sk_live_...)
Webhook SecretLeave blank for now — you’ll add this after setting up the webhook
  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): 
    https://api.fluxrate.co/api/v1/webhooks/stripe/tenant_{your_org_id}/{env_id}
  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:
FieldSource in payloadPurpose
invoice_iddata.object.metadata.invoice_idLinks event to a Fluxrate invoice
customer_iddata.object.metadata.customer_idLinks event to a Fluxrate customer
amountdata.object.amount ÷ 100Payment amount in major currency unit
currencydata.object.currency (uppercased)ISO 4217 currency code
provider_payment_iddata.object.payment_intent or data.object.idStripe payment reference
Events that trigger invoice payment:
  • checkout.session.completed
  • payment_intent.succeeded

​
Managing the Integration

ActionHow
Rotate API keyManage → enter new secret key → Save Changes
Rotate webhook secretManage → enter new webhook secret → Save Changes
Temporarily disableToggle is_active via API or disconnect from dashboard
Remove entirelyDashboard → Integrations → ··· → Disconnect

​
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.