Setup guide · Subscription billing

Connect Stripe, step by step.

Connect Stripe to Efficyon to analyze every SaaS subscription billed through your account. Read-only restricted-key auth; setup takes 3 minutes. The first analysis surfaces price drift, dead retries, and overlap within 5 minutes.

Before you start

What you'll need. Three things, all standard.

Most teams already have all three. If you don't, the setup will fail fast with a clear error rather than half-connecting and confusing the analysis.

  • 01A Stripe account with permission to create restricted API keys (typically the account owner or a developer with API key access).
  • 02Subscriptions actually billed through Stripe — Efficyon analyzes what runs through your account, so the more SaaS-on-Stripe you have, the more we can surface.

Permissions · Read-only

Exactly what Stripe will ask you to authorize. No more, no less.

Every scope listed below is read-only. We can't write, modify, or delete anything — that's not a policy choice, it's encoded in the OAuth grant your account approves.

01 · Customers · read

Read customer records to associate subscriptions with vendors for analysis.

02 · Subscriptions · read

Read subscription objects to detect price changes, status, billing cadence.

03 · Invoices · read

Read past invoices to track historical billing patterns and detect retries.

04 · Products + Prices · read

Read product/price data to map subscriptions to their pricing tiers.

05 · Charges · read

Read charge events to identify failed retries and refund patterns.

The flow

3 steps, about 6–9 minutes total.

If you've connected an OAuth app before, this will look familiar. We've added detail on the parts that are specific to this provider.

  1. 01

    Generate a restricted Stripe API key

    In Stripe Dashboard → Developers → API keys → Restricted keys → Create restricted key. Set every permission listed above to 'Read', leave everything else as 'None'. Name the key 'Efficyon read-only'.

  2. 02

    Paste the restricted key into Efficyon

    Sign in to Efficyon → Integrations → Connect Stripe. Paste the restricted key we showed you. We never store the key in plaintext — it's encrypted at rest with AES-256 and only decrypted in-memory during a sync run.

  3. 03

    First analysis runs automatically

    We pull subscription, invoice, and charge data for the last 12 months. Analysis runs concurrently and surfaces price drift, failed-retry loops, and SaaS overlap within 5 minutes for a typical SMB account.

What happens after

You'll see all Stripe-billed SaaS subscriptions categorized on the Tools tab. The Findings tab surfaces price-drift events (silent annual increases), failed-retry loops (where Stripe is trying to charge a card that no longer works), and dormant subscriptions where activity has dropped to zero but billing continues.

How to revoke

Two ways: revoke the restricted key from your Stripe Dashboard (Developers → API keys → click the key → Reveal → Delete), or disconnect from Efficyon's Settings → Integrations → Stripe → Revoke. Both stop the sync within a minute.

FAQ

The questions people actually ask.

Things people considering Stripe + Efficyon ask, with honest answers — including where we say no, or where we'd rather wait until something is true.

Why a restricted key instead of OAuth?

Stripe Connect OAuth is designed for platforms that act on behalf of the account. We're a read-only analyst, so a restricted key with read-only scopes is the more appropriate (and more auditable) auth method.

Can Efficyon refund or charge anything?

No. The restricted key permissions we ask for are all 'Read'. There's no charge, refund, or transfer endpoint in our allowlist — even if the key were compromised, the worst case is a data leak, not money movement.

Do you support Stripe-on-platform (Connect) accounts?

Standalone Stripe accounts work today. For Stripe Connect platforms (where you're the platform billing on behalf of merchants), reach out — we have a Connect-aware variant in beta.

How do you handle test-mode keys?

We refuse them. Efficyon only accepts live-mode restricted keys to avoid analyzing fake data. If you paste a test key, the connection fails fast with a clear error.

Get started

Ready to connect Stripe? The first scan is free.

No credit card. Read-only access. If we don't surface at least 5× our fee in the first 30 days, you don't pay.