Saltar al contenido principal
Un trial es una cantidad de días gratuitos configurada en el precio de un plan. Las Offers solo contienen descuentos; un descuento empieza después de la prueba.

Configurar días de prueba en un precio

En el dashboard, abre Plans, selecciona el plan y abre el precio. Ingresa los días en Free trial, elige si Require a payment method y elige Save to draft. La prueba aplica a las suscripciones nuevas cuando publicas el borrador.
Las variantes de precio heredan la prueba de su precio base. Los precios de pago único no pueden tener prueba. Una suscripción conserva los días de prueba que aceptó. Cambiar trialDays publica una nueva versión del plan y solo afecta a las suscripciones nuevas.

Empezar un trial con método de pago

Redirige al cliente a checkoutUrl. El checkout guarda el método de pago sin cobrarlo, y la suscripción pasa a trialing con trialEndsAt. Cuando termina la prueba, Commet cobra el precio seleccionado de la versión del plan de la suscripción y la suscripción pasa a active. Un promo code ingresado en el checkout de la prueba descuenta el primer recibo después de ella.

Empezar un trial sin método de pago

Un precio con trialRequiresPaymentMethod: false rechaza offerId, promoCode, cardPromotionId y provider al crear la suscripción con 400. Una organización que todavía no puede cobrar recibe 403.
La prueba empieza en el momento, sin checkout ni cobro. El cliente agrega una tarjeta desde el Portal del Cliente (Agregar tarjeta) o con un link de subscriptions.updatePaymentMethod. Cuando la prueba termina sin tarjeta:
  • La suscripción pasa al plan predeterminado del grupo de planes y se dispara subscription.plan_changed.
  • Sin plan predeterminado, la suscripción se cancela con cancelReason: "trial_ended_without_payment_method".
  • No se genera recibo. En ambos casos se dispara trial.expired.
Si el cliente agregó una tarjeta, la prueba termina igual que una que empezó con método de pago. Durante la prueba, un cambio de plan inmediato devuelve 409 no_payment_method. Los cambios programados siguen aplicando.

Cambiar el trial por suscripción

Ambos se combinan con offerId. El descuento de la Offer empieza después de la prueba.

Elegibilidad

Un cliente tiene una prueba por plan. Un cliente que ya tuvo el plan, en prueba o pagando, no recibe prueba y pasa por el checkout normal, también con customTrialDays. prepaidPeriods mayor que 1 y cancelAtPeriodEnd: true omiten la prueba del precio; con customTrialDays mayor que 0 devuelven 400. cardPromotionId omite una prueba que requiere método de pago.

Webhooks del trial

Limitaciones

  • trialDays acepta de 0 a 730. El dashboard acepta días enteros de 1 a 730; déjalo vacío para no tener prueba.
  • Una prueba por cliente y por plan.
  • Las pruebas no se combinan con prepaidPeriods mayor que 1 ni con cancelAtPeriodEnd: true.
  • Una prueba sin método de pago no puede empezar con una Offer, un promo code, una card promotion ni un provider.