CommetCommet
GitHubDiscordStatus

Billing fundamentals

How Billing WorksPricing ChangesBilling IntervalsInvoices

Subscriptions

Plan ChangesProrationTrialsFree PlansPayment Failures

Consumption and pricing

SeatsQuotaDiscountsCredits, Credit Packs, and Customer CreditsBalance and Top-UpsOffers, Promo Codes, and Card Promotions

Payments

Payment RoutingRefunds and Retries
DocumentationKnowledge BaseBuild with AIAPI ReferenceWebhooks

Offers, Promo Codes, and Card Promotions

Understand where commercial terms live and how each distribution channel selects them.

An Offer owns the economic terms: trial, percentage discount, amount off, or temporary fixed price. Introductory Offers, direct Promotional Offers, Promo Codes, and Card Promotions decide how those terms reach a customer.

ChannelWho selects itAdditional rule
IntroductoryCommet selects it from the plan priceNew-customer eligibility
Direct PromotionalYour application sends offerIdYour application decides the audience
Promo CodeCustomer enters a codePlan, interval, expiration, and redemption limits
Card PromotionYour application preselects cardPromotionId, or Commet discovers an auto-apply promotion; checkout verifies the cardBIN, billing interval, and Offer compatibility

Only one channel applies to the initial checkout. An explicit Offer overrides automatic introductory selection. A Promo Code cannot combine with an explicit Offer, and a Card Promotion must remain conditional until the entered card is verified.

When terms are accepted, Commet stores an immutable Offer Application. Editing the catalog Offer changes future applications, not the phases already accepted by an existing subscription.

See Offers and Card Promotions for setup.

How is this guide?

Balance and Top-Ups

Understand recurring balance, paid top-ups, administrative adjustments, and reset behavior.

Payment Routing

Understand how Commet chooses a provider and why existing saved methods stay on their original connection.