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
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
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.
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 concustomTrialDays.
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
trial.checkout_ready: el link del checkout de la prueba está listo.trial.started: empezó la prueba. Otorga el acceso.trial.will_end: la prueba termina en 3 días o menos.trial.converted: el cliente cambió de plan antes de que terminara la prueba.trial.expired: la prueba se agotó.
Limitaciones
trialDaysacepta de0a730. El dashboard acepta días enteros de1a730; déjalo vacío para no tener prueba.- Una prueba por cliente y por plan.
- Las pruebas no se combinan con
prepaidPeriodsmayor que1ni concancelAtPeriodEnd: true. - Una prueba sin método de pago no puede empezar con una Offer, un promo code, una card promotion ni un
provider.