Suspender el cobro de suscripciones

El cobro de pagos se suele suspender para ofrecer temporalmente los servicios de forma gratuita. Esto a veces se denomina «período de gracia» si un cliente necesita más tiempo para pagar o no puede pagar uno o más ciclos de facturación.

Puedes suspender o reanudar el cobro en el Dashboard de Stripe o en la API. Mientras el cobro está suspendido, las suscripciones siguen generando facturas, pero tienes algunas opciones para gestionarlas. Revisa los siguientes casos de uso para determinar el enfoque que más te convenga:

Si ninguna de estas opciones se adapta a tu caso de uso, quizás te convenga cancelar las suscripciones.

Se seguirán haciendo reintentos para las facturas creadas antes de haber suspendido la suscripción, a menos que las anules.

Ofrecer servicios gratis temporalmente y nunca cobrar pagos

Si temporalmente quieres ofrecer tus servicios de forma gratuita y no quieres cobrar el pago de la factura (por ejemplo, un “período de gracia”), puedes anular las facturas creadas por tu suscripción para asegurarte de que no se les cobre a tus clientes y que la suscripción permanezca status=active. Usa el ID de suscripción para actualizar pause_collection[behavior] con el valor void y pause_collection[resumes_at] con la fecha en que quieras reanudar el cobro.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=void

Todas las facturas creadas antes de la fecha resumes_at se marcan inmediatamente como nulas. Stripe no enviará los próximos correos electrónicos ni los webhooks por estas facturas, y el estado de la suscripción no se modificará.

Si no defines una fecha resumes_at, la suscripción seguirá suspendida hasta que anules pause_collection.

Ofrecer servicios gratis temporalmente y cobrar más adelante

Si quieres prestar servicios gratis temporalmente y cobrar más adelante, debes definir pause_collection[behavior]=keep_as_draft. Si sabes cuándo reanudarás el cobro, especifica una marca de tiempo en resumes_at.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=keep_as_draft

El estado de todas las facturas creadas antes de la fecha resumes_at sigue siendo draft y auto_advance se establece en false. Durante este tiempo, Stripe no enviará los próximos correos electrónicos ni los webhooks por estas facturas, y el estado de la suscripción no se modificará.

Si no defines una fecha resumes_at, la suscripción seguirá suspendida hasta que anules pause_collection.

Cuando esté todo listo para cobrar el pago de estas facturas, vuelve a definir auto_advance en true. Si no tienes los ID de las facturas, puedes usar los ID de las suscripciones para buscar las facturas con status=draft. Con el ID de la factura, puedes actualizar auto_advance=true:

curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d auto_advance=true

Ofrecer servicios de manera gratuita temporalmente y marcar las facturas como incobrables

Si temporalmente quieres ofrecer tus servicios de manera gratuita y marcar como incobrables las facturas generadas por la suscripción, usa el ID de la suscripción para actualizar pause_collection[behavior] a mark_uncollectible y, opcionalmente, a pause_collection[resumes_at] a la fecha en que quieras reanudar el cobro. Esto garantiza que los informes posteriores sean precisos, que no se le cobre al cliente y que la suscripción permanezca status=active.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=mark_uncollectible

Si estableces pause_collection[behavior] en mark_uncollectible, detendremos el cobro activo de pagos en las facturas nuevas que la suscripción cree antes de la fecha resumes_at. Stripe no enviará los próximos correos electrónicos ni los webhooks por estas facturas.

A pesar de esta suspensión, Stripe aplica todo el saldo existente del cliente a las facturas. Este comportamiento ayuda a usar los fondos disponibles antes de que marquemos una factura como uncollectible. Si el total de la factura se paga en su totalidad con el saldo del cliente, el estado de la factura se establece en paid. De lo contrario, el estado de la factura pasa a uncollectible.

Si no defines una fecha resumes_at, el cobro de pagos de la suscripción seguirá suspendido hasta que anules pause_collection.

Cómo cancelar la suspensión manualmente

Para reanudar el cobro en cualquier momento, puedes actualizar la suscripción y anular pause_collection:

curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "pause_collection"=

Si se reanuda el cobro de esta manera, solo se ven afectadas las futuras facturas.

Suspensión y calendarios de suscripciones

Si suspendes una suscripción en un calendario de suscripciones, las actualizaciones programadas entrarán en vigencia de todos modos. Sin embargo, el pago no se cobrará mientras la suscripción esté suspendida. Cuando quieras volver a cobrar, tendrás que reanudar manualmente la suscripción. También deberás establecer auto_advance en true en las facturas con estado status=draft que quieras cobrar.