# Suspender el cobro de suscripciones Aprende a suspender el cobro de las suscripciones A menudo, se suele suspender el cobro de pagos para ofrecer tus servicios de forma gratuita temporalmente. Esto a veces se conoce como “período de gracia” si un cliente necesita tiempo adicional para pagar o no puede pagar uno o más períodos de facturación. Puedes suspender o reanudar el cobro en el [Stripe Dashboard](https://support.stripe.com/questions/how-to-pause-or-cancel-subscriptions) o la API. Mientras el cobro está suspendido, las *suscripciones* siguen generando *facturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice), pero tienes algunas opciones para gestionar estas facturas. Revisa los siguientes casos de uso para determinar cuál es el mejor enfoque para ti: | Caso de uso | Configuración de la API | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- | | [Ofrecer servicios gratis temporalmente y nunca cobrar pagos](https://docs.stripe.com/billing/subscriptions/pause-payment.md#collect-payment-never) | Utiliza `behavior=void` | | [Ofrecer servicios gratis temporalmente y cobrar más adelante](https://docs.stripe.com/billing/subscriptions/pause-payment.md#collect-payment-later) | Utiliza `behavior=keep_as_draft` | | [Ofrecer servicios gratis temporalmente y marcar la factura como incobrable](https://docs.stripe.com/billing/subscriptions/pause-payment.md#mark-as-uncollectible) | Utiliza `behavior=mark_uncollectible` | Si ninguna de estas opciones se adapta a tu caso de uso, quizás te convenga [cancelar las suscripciones](https://docs.stripe.com/billing/subscriptions/cancel.md). Se seguirán haciendo [reintentos](https://docs.stripe.com/invoicing/automatic-collection.md) para las facturas creadas antes de haber suspendido la suscripción, a menos que las [anules](https://docs.stripe.com/api/invoices/void.md). ## 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 curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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 curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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`. > Si tienes una lógica personalizada para finalizar las facturas, es posible que debas desactivarla o modificarla de modo que no entre en conflicto con esta configuración. 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 curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \ -u "<>:" \ -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 curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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 ```bash curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \ -u <>: \ -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 el [calendario de suscripciones](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md), las actualizaciones programadas siguen en vigor. No obstante, no se cobra la suscripción mientras esta esté suspendida. Si quieras reanudar el pago, tendrás que [anular la suscripción manualmente](https://docs.stripe.com/billing/subscriptions/pause-payment.md#unpausing) y también establecer `auto_advance` en `verdadero` en las facturas con estado `status=draft` que quieras cobrar.