Manage Stripe connection
Billing
Kinde’s billing feature comes with a dependency on Stripe, which is a globally known and reliable payments processing platform. A new Stripe account is automatically created for you when you set up billing in Kinde.
You can’t currently connect your existing Stripe account, but you will be able to copy across your business information from your existing account to the new account. This is a Stripe-imposed limitation for third party integrations. We’re working on a migration strategy.
If you are testing billing, switch to your non-production environment. This will automatically trigger the use of a test Stripe account as well.
Go to Settings > Environment > Billing.
Select Connect Stripe account. Kinde initiates the connection and adds the connection card.
Select Update Stripe information. This kicks off a Stripe onboarding flow. You will see a Stripe-generated screen to enter details.
If the Stripe flow doesn’t appear and you remain in the Kinde dashboard, select Update Stripe information.
Enter the email that will be associated with the Stripe account and select Submit. Here’s what happens next, depending if you have a Stripe account already associated with your email address.
If you are in the test environment, you’ll be prompted through a flow. You can continue or select Return to Kinde.
If you are in a production environment, you will be asked if you want to use details from an existing Stripe account or make a new one:
You can select Return to Kinde at any time. You do not have to set up the connection fully until you are ready to publish plans. Any time you want to complete the setup, select Update Stripe information.
When you complete the Stripe onboarding, or opt out by selecting Return to Kinde, the connection card on the Kinde Billing page shows the connection status.
Connecting means Stripe is still sending information to Kinde about the account status. It should not take long to sync.In progress indicates that Stripe has connected to Kinde, but still requires some additional details from you in order to fully set up the account. Select Update Stripe information to complete the Stripe onboarding. You need to do this before plans can be made available to your customers.Connected means Stripe is successfully syncing data with Kinde and you’re ready to publish plans.After Stripe is connected, you can turn on automatic tax for new subscriptions.
Go to Settings > Environment > Billing.
In the Settings section (alongside Default currency), turn on Collect tax automatically.
Select Save.
This setting is off by default. When it is on, Kinde enables Stripe Tax on new subscriptions unless a plan overrides it with Collect or Don’t collect in plan settings.
You still need to complete Stripe Tax setup in the Stripe Dashboard (for example tax registrations for the regions where you sell). Until a customer has a billing country—such as during a trial before a card is added—tax may temporarily use your Stripe account’s registered address.
After Stripe is connected, you can collect legal billing details from organization customers on the payment step. Kinde saves the Bill-to name, address, and optional tax ID on the Stripe customer so invoices and Stripe Tax can use them.
User plans are not affected. They still collect payment method details only.
Go to Settings > Environment > Billing.
In the Settings section, turn on Collect billing details on payment step for organization billing.
Select Save.
Environments that already had billing before this option shipped keep the setting off, so existing checkout stays payment-method-only until you turn it on. New environments start with the setting on. You can change it at any time. If a customer is already on the payment step, they keep the experience that checkout started with.
When the setting is on, organization customers see Billing details above Payment method details. They enter a full name, billing address, and business name (required). A tax ID is optional. If they add one, it can appear on invoices.
If an organization is created during sign-up with the placeholder name Organization followed by a number, and the customer enters a business name of 64 characters or fewer, Kinde uses that name as the organization name. Organizations that already have a name are not renamed.
This pairs with Collect tax automatically. Stripe Tax needs a billing country. With this setting on, organization customers supply that country (and an optional tax ID) in Kinde instead of relying only on the card’s country.
After subscribe, organization members can update contact details (email, phone, and description), the billing address, and tax IDs in the self-serve portal. You can edit those same fields from the organization or user Billing page. The full name and business name collected on this step are not edited there. This billing information is stored separately from the organization’s profile name. Kinde copies the business name onto the profile only in the placeholder case above. See Enable self-serve portal for organizations and Subscription upgrade and downgrade methods.
After you have connected to Stripe, you can set policies to control what happens when a customer cancels or changes their plan. The policies are for deciding if you charge or forgive unpaid usage of metered features, or if you refund or retain unused, paid subscription days.