Create subscription
Create a subscription for a customer. Requires planId or planCode plus customerId. 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-05-12. Send Commet-Version: 2026-05-12 with your request.Encabezados
Cuerpo
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.
1