> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.paymentkit.com/guides/billing/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.paymentkit.com/_mcp/server. # Billing ## Docs - [Billing overview](https://docs.paymentkit.com/guides/billing/overview.md): Manage subscriptions, invoices, and payment collection for recurring revenue. - [Subscription lifecycle](https://docs.paymentkit.com/guides/billing/subscriptions/subscription-lifecycle.md): Understand how subscriptions move through states from creation to cancellation, and how payment outcomes drive automatic transitions. - [Create a subscription](https://docs.paymentkit.com/guides/billing/subscriptions/create-a-subscription.md): Start billing a customer on a recurring schedule by creating a subscription with one or more prices. - [Update a subscription](https://docs.paymentkit.com/guides/billing/subscriptions/update-a-subscription.md): Update subscription-level settings, manage items (add/remove/modify), adjust quantities and prices, with control over proration timing and behavior for mid-cycle changes. - [Change subscription plan](https://docs.paymentkit.com/guides/billing/subscriptions/change-subscription-plan.md): Move items to different billing intervals or contract terms with automatic subscription splitting, proration handling, and support for immediate or scheduled execution. - [Subscription change requests](https://docs.paymentkit.com/guides/billing/subscriptions/subscription-change-requests.md): Multi-step workflow for previewing and applying subscription changes with explicit payment control, conflict resolution, and idempotent retry support. - [Plan change events](https://docs.paymentkit.com/guides/billing/subscriptions/plan-change-events.md): Which webhook events fire for every kind of subscription plan change — upgrades, downgrades, and changes during a trial — what each payload carries, and why you should never detect a plan change from invoice.paid. - [Pause a subscription](https://docs.paymentkit.com/guides/billing/subscriptions/pause-a-subscription.md): Temporarily suspend billing on a subscription without cancelling it. Configure when to pause and when to automatically resume. - [Cancel a subscription](https://docs.paymentkit.com/guides/billing/subscriptions/cancel-a-subscription.md): End a subscription immediately, at period end, or on a scheduled date. Choose a refund strategy that fits your use case. - [Create an invoice](https://docs.paymentkit.com/guides/billing/invoices/create-an-invoice.md): Generate one-off invoices for custom charges, or understand how subscription invoices are created automatically. - [Customize an invoice](https://docs.paymentkit.com/guides/billing/invoices/customize-an-invoice.md): Configure payment terms, collection methods, metadata, and custom fields on invoices. - [Pending invoice items](https://docs.paymentkit.com/guides/billing/invoices/pending-invoice-items.md): Add one-off charges to a subscription and collect them at renewal or on demand. - [Issue a refund](https://docs.paymentkit.com/guides/billing/issue-a-refund.md): Return funds to a customer for a charge, a payment intent, or a paid invoice — in full or in part. - [Credit notes & credit balance](https://docs.paymentkit.com/guides/billing/credit-notes-credit-balance.md): Hold a credit balance for a customer and apply it automatically to future invoices. - [Automatic retries & emails](https://docs.paymentkit.com/guides/billing/dunning-recovery/automatic-retries-emails.md): PaymentKit’s dunning system automatically recovers failed payments through retries and emails while giving you control over subscription and invoice outcomes when all payment attempts fail. - [Dunning profiles](https://docs.paymentkit.com/guides/billing/dunning-recovery/dunning-profiles.md): Customize retry schedules and failure handling for different subscription types with dunning profiles.