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.Headers
Body
- Option 1
- Option 2
- Option 3
- Option 4
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 <= 60Public ID of a published version of the plan, current or not, including an experiment's versions. The subscription is created on that version and stays on it: checkout charges its price and activation grants its credits, add-ons and credit packs. When omitted, the subscription gets the current version, or the version an experiment code (planCode <plan code>:<experiment code>) sells.
1Response
Success
Whether 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