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..d4b580a34d 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. +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? 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 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.