subscription-integration
Build subscription billing into your app with Dodo Payments, handling trials, plan transitions, and usage-based pricing. Manage the full subscription lifecycle through webhook events—from activation through renewal and cancellation—with built-in customer portal support.
Subscription Integration helps you implement recurring billing with Dodo Payments, including trials, plan changes, and webhook event handling.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-05-30
Subscription Integration helps you implement recurring billing with Dodo Payments, including trials, plan changes, and webhook event handling. Build subscription billing into your app with Dodo Payments, handling trials, plan transitions, and usage-based pricing. Manage the full subscription lifecycle through webhook events—from activation through renewal and cancellation—with built-in customer portal support.
Use it when
- subscription-integration processes Dodo Payments subscription webhooks to keep your app in sync with billing changes.
- Yes.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
dodopayments/skills/subscription-integration
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I set up recurring billing with Dodo Payments?
subscription-integration enables recurring billing by creating subscription objects tied to your customer and plan. Define your billing cycle, trial period, and pricing model (fixed or usage-based) in your plan configuration. subscription-integration handles charge scheduling automatically and sends webhook events at each lifecycle milestone—creation, renewal, and cancellation—so your backend stays synchronized with billing state.
How does subscription-integration handle webhook events?
subscription-integration processes Dodo Payments subscription webhooks to keep your app in sync with billing changes. Key events include subscription.active (customer gains access), subscription.cancelled (revoke access), subscription.renewal (charge processed), and subscription.failed_payment (retry logic triggered). Your app listens for these events, updates customer entitlements, and manages access control based on subscription status.
Can I implement a trial period in subscription checkout?
Yes. subscription-integration lets you configure trial duration and trial pricing (often free or discounted) at plan creation. During the trial, the customer has full access but no charge occurs until the trial ends. On trial expiration, subscription-integration automatically transitions to paid billing and fires a subscription.active event so you can confirm the upgrade or handle payment failure.
How do I upgrade or downgrade a subscription plan?
subscription-integration supports mid-cycle plan changes through its upgrade/downgrade endpoints. When a customer switches plans, subscription-integration calculates proration—crediting unused time from the old plan or charging for the new plan's higher tier. The change takes effect immediately, and a webhook event notifies your backend so you can update customer entitlements and access permissions.
What happens when a subscription payment fails?
subscription-integration retries failed payments according to your grace period and retry policy. During the grace period, the customer retains access while Dodo Payments attempts collection. If payment succeeds, a subscription.renewal event fires. If all retries fail, subscription-integration sends subscription.failed_payment or subscription.cancelled, prompting your app to revoke access and notify the customer.
How does subscription-integration support usage-based billing?
subscription-integration tracks metered usage through usage events you report during the billing cycle. At renewal, subscription-integration calculates charges based on your usage tier or per-unit pricing and applies the total to the next invoice. This model works alongside fixed subscription fees, letting you bill for both base access and consumption. Webhooks confirm each usage-based charge.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Dodo Payments Subscription Integration
Reference: docs.dodopayments.com/developer-resources/subscription-integration-guide
Implement recurring billing with trials, plan changes, and usage-based pricing.
Quick Start
1. Create Subscription Product
In the dashboard (Products → Create Product): - Select "Subscription" type - Set billing interval (monthly, yearly, etc.) - Configure pricing
2. Create Checkout Session
```typescript import DodoPayments from 'dodopayments';
const client = new DodoPayments({ bearerToken: process.env.DODO_PAYMENTS_API_KEY, });
const session = await client.checkoutSessions.create({ product_cart: [ { product_id: 'prod_monthly_plan', quantity: 1 } ], subscription_data: { trial_period_days: 14, // Optional trial }, customer: { email: 'subscriber@example.com', name: 'Jane Doe', }, return_url: 'https://yoursite.com/success', });
// Redirect to
(truncated - see the full file via the links below)
File tree — 1 file
dodo-payments/subscription-integration/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Implement recurring billing with trials, plan changes, and webhook handling”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill teaches you to create subscription products in WooCommerce with configurable billing periods, free trials, and sign-up fees. Learn to hook into subscription lifecycle events—activation, renewal success, payment failure, and cancellation—to automate access control and business logic. Handle plan upgrades, downgrades, and payment retries programmatically.
Stripe Integration provides server-side and client-side patterns for implementing payments with the Node.js SDK and React Stripe.js. Handle one-time payments, recurring subscriptions, hosted checkout, custom payment forms, and webhook verification. Reference guides cover checkout flows, subscription lifecycle, webhook event handling, and pre-built UI components.
This skill covers PayPal payment integration across multiple products and methods. Set up one-time payments and express checkout flows, configure recurring billing and subscriptions, handle refunds and disputes, and process webhooks for real-time payment notifications. Includes both client-side JavaScript SDK and server-side REST API approaches for maximum flexibility.
This skill walks you through Stripe configuration for subscription-based SaaS, from initial setup through production launch. Learn to structure pricing tiers, implement webhook handlers for subscription events, configure the Customer Portal, and recover failed payments through dunning sequences. Covers tax compliance, testing checklists, and the business decisions that prevent billing bugs from eroding customer trust.
This skill provides a complete Stripe integration for SaaS applications, covering checkout sessions, subscription management, and secure webhook handling. It includes TypeScript and Python implementations with customer portal setup and payment event processing.
billing-management handles subscription lifecycle and plan changes for XActions using Stripe. Switch between tiers, view available plans, access your billing portal, or cancel at any time. Payment details stay secure with Stripe.
More skills subscription-billing (MIT)