Create subscription
Create a subscription for a customer. Commet selects the default price when priceId is omitted. The subscription starts at the base USD price; market and currency are resolved from the buyer’s request country when the checkout opens. Without an offer override, Commet applies the price’s automatic introductory offer. Pass one Promotional Offer through offerId to override it. Experiment assignment remains external. If the subscription is saved but its initial payment checkout cannot be created, the endpoint returns subscription_activation_failed; retry the same request to recover the pending subscription without creating another invoice.
2026-07-24. Send Commet-Version: 2026-07-24 with your request.Authorizations
Headers
Unique key used to safely retry this write for 24 hours without applying it twice.
1 - 200API version used by this reference. Send this header to select this contract explicitly.
Body
- Option 1
- Option 2
- Option 3
- Option 4
1 - 2001weekly, monthly, quarterly, semiannual, yearly, one_time Public price ID. When omitted, Commet selects the default price for the billing interval and still applies its market pricing.
1Payment provider name or exact public payment connection ID for the initial checkout. Overrides country routing when present.
stripe, commet, dlocal Payment methods the initial checkout may offer. Restricts what the checkout already offers for the buyer's country, currency and payment connection; it never enables a method the connection does not have and never changes routing. When none of them is available to the buyer, the checkout shows that it cannot accept payments.
1card, oxxo, mercado_pago, google_pay, smartpix Billing periods of the subscription's interval paid with the first payment, including the current one. Defaults to 1. The interval does not change: each paid period renews at zero and the subscription renews normally after the last one unless cancelAtPeriodEnd is true.
1 <= x <= 60Schedules the cancellation from creation so the subscription ends after its last paid period and never renews with any payment method.
1Trial length in days, replacing the price's trial. A customer who already had this plan, in a trial or paying, gets no trial and goes through the regular checkout.
0 <= x <= 9007199254740991Response
Success
draft, pending_payment, trialing, active, past_due, paused, canceled weekly, monthly, quarterly, semiannual, yearly, one_time -9007199254740991 <= x <= 9007199254740991Whether Commet can charge this subscription on its own at its next charge (the trial end or the renewal). A trial that started without a payment method reports false until the customer adds one for this subscription; a payment method saved for another subscription does not count. A subscription on a free plan reports false.
Payment provider resolved for this checkout when the subscription response was created. This is an informational snapshot and may differ when the checkout is loaded if its country or the organization's routing changes.
stripe, commet, dlocal "subscription"