About billing
Billing
Top questions about Kinde billing
Here are short answers to the most common billing questions. Click any question to expand the answer.
Core billing functionality in Kinde
Link to this sectionHow do I choose the right Kinde billing pricing model for my SaaS customers?
Choose a model based on how users receive value from your product. If usage varies significantly (for example API calls or storage), usage-based pricing is often appropriate. If value is tied to access, fixed subscription pricing is often clearer. Kinde supports combining both within the same plan, such as a base subscription plus metered usage.
Start with a simple model and add complexity only when it is needed. Explore pricing models | About billing concepts
What is the difference between Kinde metered and unmetered features in plans?
Metered features are measured quantities, such as monthly active users, API calls, storage, or support hours. They can be chargeable (priced per unit) or included up to a defined limit. Unmetered features are access controls that are either enabled or disabled for a plan. Most products use a combination of both to define clear upgrade paths. About plans and features | Billing concepts guide
How do Kinde plan groups help me organize billing for different customer types?
Plan groups help separate B2B and B2C offerings in a structured way. Each group is tied to either individuals or organizations, not both. For example, you can have one group for individual plans and another for organization-based plans. You can create multiple pricing tables from one group, but each table can only include plans from that same group. Plan groups management | Billing concepts
Why should I use Kinde billing features instead of building a custom payment system?
Kinde billing reduces implementation overhead for subscription management, dunning, proration, and billing integration. It includes Stripe integration, plan upgrades, usage tracking, invoice support, and a self-serve portal. This lets your team focus on product development rather than billing infrastructure. About billing plans | Self-serve portal setup
How does Kinde handle the technical complexity of subscription billing?
Kinde abstracts key subscription-billing operations. After Stripe setup, plan changes, usage tracking, proration behavior, and invoice events are synchronized through the platform. You can also configure webhooks for important billing events so your application remains in sync. Stripe integration guide | About billing plans
What happens when I publish a plan versus keeping it in draft, in Kinde?
Draft plans can be updated freely without affecting subscribers. When a plan is published, it syncs to Stripe and becomes available for subscriptions. After users subscribe, core plan settings should be treated as stable. This helps prevent unexpected pricing changes for existing subscribers. About plans lifecycle | Billing concepts
Can I offer a free plan without requiring credit card details?
Yes, when creating or editing a plan, you’ll find an Ask for credit card toggle in the Plan settings section. For plans with no charges, you can disable this toggle so users can subscribe without entering payment information. This is great for reducing friction on free tiers. However, if your plan includes any fixed charges or metered/usage-based billing, credit card collection is always required regardless of this setting. Create and configure plans | About plans
Stripe integration
Link to this sectionWhy does Kinde create a new Stripe account instead of connecting to my existing one?
This behavior is required by Stripe for third-party integrations. Stripe controls how connected accounts are provisioned for security and compliance. During onboarding, you can transfer existing business details, so setup does not need to start from zero. Stripe connection setup | Manage Stripe connection
What should I tell customers when my Kinde–Stripe connection shows “In progress” status?
“In progress” usually means Stripe requires additional information to complete setup, such as business details, tax information, or identity verification. Live payments are not available until setup is completed. Use the “Update Stripe information” action in Kinde to review and complete required details. When completed, the status changes to “Connected”. Stripe connection troubleshooting | Connect to Stripe guide
How do I test Kinde billing without charging real money?
Switch to a non-production environment in Kinde to use a Stripe test account that does not process real payments. You can validate plans, checkout behavior, and failure scenarios without charging real cards. Move back to production only when testing is complete. Stripe integration setup | About billing plans
Plan management
Link to this sectionHow should I structure Kinde billing plans to make upgrading feel natural for customers?
Create a clear progression where each plan builds on the previous tier. Start with a useful entry tier, then increase limits and add features at higher tiers. Metered limits can help users understand upgrade value.
Use simple, descriptive plan names that communicate audience or scale clearly. About pricing models | Plan management guide
How should I handle Kinde plan features that only some users need?
Use unmetered features to gate premium capabilities by plan, and use metered features when usage varies by customer. This keeps lower tiers focused while providing a clear upgrade path for advanced needs. Feature planning strategy | Billing concepts
How do I explain Kinde’s tiered pricing to customers who are confused about usage charges?
Explain tiered pricing with clear formulas and concrete examples. For example, if pricing changes after a usage threshold, show a full sample calculation in the pricing table. Use clear limits in lower tiers to make budgeting and upgrade decisions easier. Pricing models explained | Build a pricing table
What should I consider when setting Kinde plan upgrade and downgrade policies?
Define upgrade and downgrade policies that are predictable for both your team and your users. By default, Kinde can apply standard policy behavior for downgrades and subscription timing. If needed, customize policies to match your business model and communicate them clearly. Plan policies configuration | Billing setup guide
User experience
Link to this sectionHow do I create effective Kinde pricing tables for conversion?
Keep pricing tables concise. In most cases, 3-4 tiers are enough. Highlight a recommended plan, emphasize user outcomes, and clearly distinguish feature and usage limits by tier. For complex products, consider a custom pricing-table design with clearer grouping and language. Build effective pricing tables | Pricing table customization
Should I show Kinde pricing tables during the signup flow or after users experience my product?
It depends on your product complexity and buying motion. For straightforward products, showing pricing during signup can work well. For products with a longer value-discovery cycle, showing pricing after initial product experience may perform better. Kinde supports both patterns through pricing-table display settings. Pricing table display options | Billing integration guide
How do I handle customers who need custom pricing that doesn’t fit Kinde’s standard plans?
Start by mapping those customers to existing plans with adjusted feature limits where possible. If a fully custom model is required, you can apply targeted metered-usage adjustments through the Kinde API. For enterprise contract scenarios, coordinate with Kinde enterprise support. API billing management | Enterprise billing options
Self-serve portal
Link to this sectionHow does Kinde’s self-serve portal reduce my customer support workload?
The self-serve portal lets customers update payment details, view billing history, manage plans, and handle organization billing actions without opening support tickets. You control which actions are self-managed through permissions. Portal links are secure and one-time use, so they can be embedded in your application safely. Self-serve portal setup | Portal configuration options
What permissions should I give organization members via Kinde’s self-serve portal feature?
Start with restricted permissions and expand access as needed. In most cases, billing administrators should manage payment methods and billing history, while broader teams should have limited billing controls. Kinde maps portal capabilities to system permissions such as org:write:billing for granular access control.
Portal permissions setup.
How do I generate Kinde self-serve portal links for use in my app?
There are two common options. If you use Kinde authentication, generate portal links through the SDK. For server-side flows, use the Kinde Management API with an M2M token. You can specify the portal section and post-portal redirect target. Because links are one-time use, generate a fresh link per request. Portal link generation | Management API integration
Integration and development
Link to this sectionHow do I sync Kinde billing data with my application’s feature access controls?
Use the Account API to read feature entitlements and usage limits for signed-in users. For organization-level billing data, use the Management API. Configure billing webhooks for plan and usage updates so feature access stays synchronized. Keep cache durations short for entitlement-sensitive decisions. Account API for billing | Billing webhooks
How should I handle Kinde billing webhook events in my application?
Set up dedicated endpoints for billing webhooks and verify JWT signatures on incoming requests. Handle key events such as subscription changes, payment failures, and usage updates. Return HTTP 200 for successfully processed events so retries stop. Use webhook request IDs as idempotency keys to prevent duplicate processing. Webhook implementation | Webhook setup guide
How do I implement Kinde billing URLs and parameters for seamless user experiences?
Use URL parameters to direct users to specific plans or pricing tables, such as ?plan=pro_monthly. This is useful for campaigns, in-app upgrade prompts, and targeted landing pages. You can also override table display behavior through parameters, while still using SDK helpers where appropriate.
Billing URL integration | Pricing table configuration
Troubleshooting and support
Link to this sectionWhy are plan prices not syncing from Kinde to Stripe?
If “price not synced” appears, confirm the plan is published because only published plans sync to Stripe. Mixed sync states can occur when some features are already published and others are newly added. Re-publish the plan to trigger synchronization, then verify Stripe connection status is “Connected”. Plan publishing process | Stripe connection status
What should I do when customers report billing discrepancies?
Start by reviewing billing history in the organization portal to verify charge timing and amounts. Check for plan changes, proration events, metered overages, and payment retries. Many discrepancy reports are timing-related invoice expectations rather than calculation errors. If an error remains, escalate with detailed billing context. Billing history access | Support resources
What are current Kinde billing limitations?
Current limitations include custom billing period support (forthnightly, etc.), no free-trial option, and limited plan-versioning options. Workarounds include annual-equivalent plans and free-plan onboarding with upgrade automation. Share product feedback through support channels to help prioritize roadmap improvements. Current billing limitations | Alternative approaches
Best practices
Link to this sectionWhat is the recommended way to launch Kinde billing for an existing SaaS product?
Set up plans and pricing tables in a non-production environment first. Define a migration strategy for existing users, including any grandfathering policy. Communicate pricing changes in advance. A phased rollout (new signups first, then existing users in cohorts) reduces operational risk. Billing setup strategy | Plan management
How should I price Kinde metered features to encourage growth while staying profitable?
Start with a tier structure that demonstrates value early, then use usage thresholds to create clear upgrade points. Price metered features to support adoption while preserving margin. Track unit economics by feature so pricing reflects delivery cost and customer value. Metered pricing strategies | Feature management
How can I use Kinde billing data to reduce customer churn?
Set up webhooks for payment failures and usage changes, then trigger proactive outreach before disruption occurs. If users approach limits, provide contextual upgrade prompts. Use billing patterns to identify at-risk accounts and high-value accounts, and tailor retention workflows accordingly. Billing webhooks setup | Usage tracking
How do I structure Kinde plans to minimize customer confusion while maximizing revenue?
Keep tier differences clear and limited in number. In many cases, three to four plans are sufficient. Present a clear recommended plan and make value progression explicit between tiers. Validate table clarity with usability testing before launch. Pricing table best practices | Plan strategy guide