# Suspender el cobro de suscripciones Aprende a suspender el cobro de las suscripciones Puedes suspender el cobro para ofrecerle temporalmente tus servicios sin cargo a un cliente. A esto se lo conoce a veces como «período de gracia»; por ejemplo, cuando un cliente necesita más tiempo para pagar o no puede pagar uno o más períodos de facturación. Cuando detienes el cobro de un pago, la *suscripción* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) permanece `activa` y se 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 Stripe no cobra el pago. Tu cliente sigue teniendo acceso al servicio durante este tiempo. ## Before you begin - Si quieres suspender el acceso del cliente al servicio, detener el cobro de los pagos y también interrumpir las facturas, consulta en su lugar la sección [Suspender suscripciones](https://docs.stripe.com/billing/subscriptions/pause.md). - Si quieres desactivar la renovación de forma permanente, consulta la sección [Cancelar suscripciones](https://docs.stripe.com/billing/subscriptions/cancel.md). - Las facturas creadas antes de que suspendas las suscripciones se seguirán [reintentando](https://docs.stripe.com/invoicing/automatic-collection.md) a menos que las [anules](https://docs.stripe.com/api/invoices/void.md). ## Suspende el cobro Utiliza el Dashboard o la API para pausar el cobro de pagos. Puedes optar por suspender el cobro de pagos de manera indefinida o reanudarlo de forma automática en un momento específico en el futuro. Mientras el cobro de pagos esté pausado, Stripe no enviará ningún correo electrónico ni webhook relacionado con las próximas facturas, y el estado de la suscripción permanecerá sin cambios. Cuando detienes el cobro de una suscripción, tienes tres opciones para gestionar las facturas durante el período en que se encuentra en pausa: | | | **Guardar las facturas como borradores** (`keep_as_draft`) | - Las facturas se crean en estado `borrador` con `auto_advance` configurado como falso. - Puedes finalizar la transacción y cobrar el pago más adelante. > Si tienes una lógica personalizada que finaliza las facturas, es posible que debas desactivarla o modificarla para que no entre en conflicto con esta configuración. | | **Marcar las facturas como incobrables** (`mark_uncollectible`) | - Las facturas se marcan como incobrables. No se cobran pagos correspondientes a estos períodos. Stripe no envía correos electrónicos ni webhooks sobre facturas pendientes para estas. - A pesar de esta pausa, Stripe aplica cualquier saldo existente del cliente a las facturas. Este comportamiento ayuda a utilizar los fondos disponibles antes de que marquemos una factura como incobrable. Si el total de la factura se paga en su totalidad con el saldo del cliente, entonces el estado de la factura se define como `pagada`. De lo contrario, se establece como `incobrable`. | | **Anular las facturas** (`void`) | Las facturas se anulan. No se genera ningún registro de cargos para estos períodos. | Para suspender el cobro de una suscripción, debes hacer lo siguiente: #### Dashboard 1. En la página de [Suscripciones](https://dashboard.stripe.com/subscriptions), selecciona la suscripción. 2. Haz clic en el menú de opciones adicionales (⋯) y selecciona **Pausar el cobro**. 3. Elige la duración: - **Indefinido**: mantenemos el cobro de pagos en pausa hasta que tú lo reanudes. - **Hasta una fecha personalizada**: reanudamos de forma automática el cobro en la fecha que elijas. 4. Elige el comportamiento de la factura: - **Guardar las facturas como borradores**: las facturas se crean como borradores. Puedes finalizarlas y cobrar el pago más adelante. - **Marcar las facturas como incobrables**: las facturas se marcan como incobrables. No se cobra ningún pago correspondiente a estos períodos. - **Anular las facturas**: las facturas se anulan. No se genera ningún registro de cargos para estos períodos. 5. Haz clic en **Suspender**. #### API Para suspender el cobro de una suscripción, [actualiza la suscripción](https://docs.stripe.com/api/subscriptions/update.md) y configura `pause_collection[behavior]`. De manera opcional, establece `pause_collection[resumes_at]` para reanudar automáticamente el cobro en un momento específico. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "pause_collection[behavior]=keep_as_draft" ``` ### pause_collection[behavior] Elige cómo gestionar las facturas creadas mientras el cobro está suspendido: - `keep_as_draft`: mantiene todas las facturas en estado de borrador mientras el cobro está en pausa. - `mark_uncollectible`: marca todas las facturas como incobrables mientras el cobro está en pausa. - `void`: anula todas las facturas mientras el cobro está en pausa. ### pause_collection[resumes_at] Una marca de tiempo Unix a partir de la cual la suscripción reanuda el cobro de los pagos. Si no configuras `resumes_at`, el cobro de pagos permanecerá en pausa hasta que desactives `pause_collection`. > Si pausas una suscripción que se administra mediante un calendario de suscripciones, las actualizaciones programadas seguirán aplicándose. Una transición de fase en el calendario de suscripciones no elimina de forma automática el comportamiento `pause_collection` que se configuró directamente en la suscripción. ## Reanudar el cobro de pagos Puedes reanudar el cobro en cualquier momento a través del Dashboard o la API, tanto para una suscripción como para facturas guardadas como borradores. ### Reanudar el cobro de una suscripción #### Dashboard Para reanudar el cobro de pagos en el Dashboard, debes hacer lo siguiente: 1. En la página [Suscripciones](https://dashboard.stripe.com/subscriptions), busca la suscripción correspondiente. 2. Haz clic en el menú de opciones adicionales (⋯) y selecciona **Reanudar el cobro**. #### API Para reanudar el cobro de pagos, [actualiza la suscripción](https://docs.stripe.com/api/subscriptions/update.md) y desactiva `pause_collection`. Puedes desactivar claves individuales asignándoles un valor vacío: #### curl ```bash curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \ -u <>: \ -d "pause_collection"= ``` ### Cobrar las facturas en estado de borrador Una vez que reanudes el cobro de una suscripción, configura `auto_advance=true` en cada factura en borrador. Si no tienes los ID de las facturas, búscalos con el ID de la suscripción con `status=draft` como filtro. #### Dashboard Una vez que reanudes el cobro de una suscripción, para cada factura en borrador, haz lo siguiente: 1. Ve a la [página Facturas](https://dashboard.stripe.com/invoices/) en el Dashboard y haz clic en la factura para ver su página de información. 2. Haz clic en el menú de opciones adicionales(⋯). 3. Haz clic en **Activar el cobro automático**. Esto cambia la propiedad `auto_advance` de la factura a `true`. #### API Recupera los borradores de las facturas de la suscripción: ```curl curl -G https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "subscription={{SUBSCRIPTION_ID}}" \ -d status=draft ``` A continuación, para cada factura en borrador, configura `auto_advance` como `true`: ```curl curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \ -u "<>:" \ -d auto_advance=true ``` ## See also - [Suspender suscripciones](https://docs.stripe.com/billing/subscriptions/pause.md)