Skip to content

Conversation

@SarahSoutoul
Copy link
Contributor

@SarahSoutoul SarahSoutoul commented Oct 22, 2025

🔎 Previews:

What does this solve?

This PR solves two Linear tickets at once:

The first issue is around clarifying the need for two separate Stripe accounts between dev and prod instances AND the second issue is around updating the first question of the FAQ to avoid confusion among users.

What changed?

  • For the first issue, I updated the partial that talks about the dev/ prod setups + added the clarification as a question to the FAQ too.
  • For the second issue, I updated the answer to be clearer and more detailed.

Checklist

  • I have clicked on "Files changed" and performed a thorough self-review
  • All existing checks pass

@SarahSoutoul SarahSoutoul self-assigned this Oct 22, 2025
@SarahSoutoul SarahSoutoul requested a review from a team as a code owner October 22, 2025 20:12
@vercel
Copy link

vercel bot commented Oct 22, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Updated (UTC)
clerk-docs Ready Ready Preview Oct 29, 2025 5:57pm

### Can I use an existing Stripe account with Clerk billing?

Unfortunately, there is no way to use an existing business entity with Clerk billing.
Unfortunately, Clerk Billing requires a new Stripe account to be created through Clerk. While Clerk connects directly to Stripe to handle payments, subscriptions, and billing flows, you cannot use a Stripe account that is already tied to another business entity.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Subscriptions are managed by Clerk. Stripe is used solely as a payment processor

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd also suggest removing the word Unfortunately.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


### Can I use the same Stripe account for both dev and prod environments?

No. Stripe accounts created for development instances (using the Clerk development gateway) are sandbox/test accounts and cannot be used for production. For a production environment, you must create a separate Stripe account.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🙃 The "Clerk development gateway" is a Stripe account that can be used in development. Just a minor wording comment, I think the explanation makes sense overall.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed the term here: Remove wording and refine

### Can I use an existing Stripe account with Clerk billing?

Unfortunately, there is no way to use an existing business entity with Clerk billing.
Clerk Billing requires a new Stripe account to be created through Clerk. While Clerk uses Stripe as a payment processor, you cannot use a Stripe account that is already tied to another business entity.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We're currently working on supporting this! Not sure if that's something we should add in the docs though

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, Mauricio told me, and good shout - I think it'll be good to add that.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

@alexisintech alexisintech left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i'll approve as to not block - but pending mary's suggestions 🫡

@SarahSoutoul
Copy link
Contributor Author

@mzhong9723 could I get your eyes on this again? Thank you!

@SarahSoutoul SarahSoutoul merged commit fbdec30 into main Oct 29, 2025
8 checks passed
@SarahSoutoul SarahSoutoul deleted the ss/DOCS-11050 branch October 29, 2025 17:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants