From cef6a4636e4bcbc306626bfe42d759fcf52af598 Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Wed, 22 Oct 2025 14:09:31 -0600 Subject: [PATCH 1/3] Clarify billing info --- docs/_partials/billing/enable-billing.mdx | 4 ++-- docs/guides/billing/overview.mdx | 6 +++++- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/_partials/billing/enable-billing.mdx b/docs/_partials/billing/enable-billing.mdx index f46348920e..2b426d82a1 100644 --- a/docs/_partials/billing/enable-billing.mdx +++ b/docs/_partials/billing/enable-billing.mdx @@ -8,5 +8,5 @@ Clerk billing costs just 0.7% per transaction, plus Stripe's transaction fees wh Once you have enabled billing, you will see the following **Payment gateway** options for collecting payments via Stripe: -- **Clerk development gateway**: A shared **test** Stripe account so developers can get started testing and building with billing **in development** without needing to create and configure a Stripe account. -- **Stripe account**: Use your own Stripe account. +- **Clerk development gateway**: A shared **test** Stripe account used for development instances. This allows developers to test and build billing flows **in development** without needing to create and configure a Stripe account. +- **Stripe account**: Use your own Stripe account for production. **A Stripe account created for a development instance cannot be used for production**. You will need to create a separate Stripe account for your production environment. diff --git a/docs/guides/billing/overview.mdx b/docs/guides/billing/overview.mdx index dc6f28f662..e8f58f3a91 100644 --- a/docs/guides/billing/overview.mdx +++ b/docs/guides/billing/overview.mdx @@ -31,12 +31,16 @@ Clerk billing allows your customers to purchase recurring subscriptions to your ### 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. ### Can I see subscriptions in my Stripe account? Clerk billing does not use Stripe products, prices, subscriptions, etc. Clerk manages plans and subscriptions/subscription items, and only uses Stripe for payment processing. You will still be able to see customer information, as well as payment information in your Stripe account. +### 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. + ### Is Clerk a Merchant of Record (MoR) for transactions? No, Clerk does not provide this service. From 960f450b241f820c5c997eb9b2f18ca7064a8877 Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Thu, 23 Oct 2025 10:52:34 -0600 Subject: [PATCH 2/3] Refine answer FAQ --- docs/guides/billing/overview.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/billing/overview.mdx b/docs/guides/billing/overview.mdx index e8f58f3a91..19ce3f4cbb 100644 --- a/docs/guides/billing/overview.mdx +++ b/docs/guides/billing/overview.mdx @@ -31,7 +31,7 @@ Clerk billing allows your customers to purchase recurring subscriptions to your ### Can I use an existing Stripe account 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. +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. ### Can I see subscriptions in my Stripe account? From 3482aee37fff80e1070d28328af23a559b935c25 Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Thu, 23 Oct 2025 13:19:31 -0600 Subject: [PATCH 3/3] Remove wording and refine --- docs/guides/billing/overview.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/billing/overview.mdx b/docs/guides/billing/overview.mdx index 19ce3f4cbb..d4b580a34d 100644 --- a/docs/guides/billing/overview.mdx +++ b/docs/guides/billing/overview.mdx @@ -31,7 +31,7 @@ Clerk billing allows your customers to purchase recurring subscriptions to your ### Can I use an existing Stripe account 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. +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. However, Clerk plans to roll out support for this in the future. ### Can I see subscriptions in my Stripe account? @@ -39,7 +39,7 @@ Clerk billing does not use Stripe products, prices, subscriptions, etc. Clerk ma ### 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. +No. Stripe accounts created for development instances are sandbox/test accounts and cannot be used for production. For a production environment, you must create a separate Stripe account. ### Is Clerk a Merchant of Record (MoR) for transactions?