Facturas de suscripciones

Aprende a gestionar facturas de suscripciones.

Las facturas son recursos básicos en Stripe, que representan el importe que debe un cliente. Stripe genera una factura por cada período de un ciclo de facturación subscription. También puede generar facturas manualmente a través del Dashboard o de la API para pagos fuera de ciclo o únicos. Obtenga más información sobre el ciclo de vida de las facturas independientes y las facturas generadas por suscripción.

Ciclo de vida de la factura de la suscripción

Las siguientes secciones describen cómo Stripe gestiona una factura durante el ciclo de vida de una suscripción.

Nuevas facturas de suscripciones

Cuando suscribes a un cliente, Stripe:

Crea una factura.
Finaliza la factura aproximadamente una hora después.

Si el pago se efectúa correctamente en la primera factura de la suscripción o la factura no requiere pago, la factura cambia a status=paid y se activa la suscripción.

Hasta que no se efectúe el pago, el status de la factura es open y auto_advance permanece en false. El status de la suscripción es incomplete. Obtén información sobre cómo resolver los errores de pago de las facturas de suscripciones nuevas que exigen un método de pago.

En algunos casos, también se crea una nueva factura cuando se cambia de categoría de suscripción. En estas facturas, auto_advance está deshabilitado desde el comienzo.

Cuando se finaliza una factura, no puedes agregar ítems de factura ni hacer ninguna otra modificación que afecte el importe adeudado. Sin embargo, puedes agregarle ítems de factura al cliente. Los ítems agregados se aplicarán a la próxima factura.

Nota

Stripe no genera una factura cuando creas una suscripción billing_mode=flexible que contiene solo ítems de consumo medido. La suscripción se activa de inmediato. Stripe genera una factura en el momento de la creación solo si la suscripción es antedatada con consumo acumulado previamente o si existen ítems de factura pendientes.

Facturas por renovación de suscripciones

Cuando se renuevan suscripciones, Stripe:

Crea una factura.
Mantiene el estado de la factura en draft alrededor de una hora.
Intenta finalizar y pagar la factura con el método de pago predeterminado.
Cambia el estado de la factura a paid si el pago se efectúa con éxito.

Cuando Stripe crea una factura, recibes un evento invoice.created en el punto de conexión del webhook configurado. En este caso, el atributo del estado es draft, lo que significa que las partidas de la factura están abiertas a modificaciones.

Cobrar pagos

Cuando vence una factura, Stripe intenta cobrar el pago mediante un cargo automático al método de pago guardado o a través del envío de la factura por correo electrónico a los clientes.

Reintentar pagos

Stripe ofrece varias opciones para administrar los pagos fallidos, entre ellas la funcionalidad Smart Retries que trabaja con machine learning.

Gestiona las facturas de suscripciones

En las siguientes secciones, se describe cómo realizar acciones básicas sobre las facturas en el Dashboard.

Crear una factura

Stripe crea automáticamente una factura para las suscripciones al final de cada ciclo de facturación. Finalizamos y enviamos la factura en una hora. Puedes editar la factura antes de que se finalice. Obtén más información sobre cómo modificar las facturas en la página de datos de la factura.

Previsualizar próximas facturas

La API para Recuperar una factura proporciona un mecanismo para ver una factura existente. Stripe también proporciona un punto de conexión para crear una vista previa de la factura. Esta vista previa refleja el precio base, las partidas de factura pendientes, los descuentos y los saldos de crédito del cliente existentes.

Al acceder a la vista previa, también puedes modelar el aspecto que tendría la factura si cambiaras la suscripción de alguna de las siguientes maneras:

Intercambiando el precio subyacente.
Alterando la cantidad.
Aplicando un período de prueba.
Agregando un cupón.

Actualiza la primera factura de una suscripción

La forma de editar la primera factura de una suscripción depende de la configuración del método de pago del cliente para esa suscripción. Si tienes dudas, puedes consultar la configuración del método de pago en la API o en el Dashboard.

Para comprobar el método de pago de la suscripción con la API, comprueba el valor de collection_method en el objeto Subscriptions del cliente. Un valor de send_invoice significa que Stripe envía un correo electrónico al cliente con su factura. Un valor de charge_automatically significa que Stripe cobra al cliente en tu nombre usando su método de pago predeterminado.

Para comprobar el método de pago de la suscripción en el Dashboard, abre la página de suscripciones. Luego, haz click en la suscripción que deseas verificar para abrir la vista detallada. En la sección ** Datos de suscripción **, el valor del campo Método de facturación define el método de pago: Cargar método de pago predeterminado o Enviar factura.

Para los clientes que reciben facturas, tienes un período de una hora a partir de que esta se creó para que Stripe finalice la suscripción. En ese período, puedes realizar los cambios necesarios en la suscripción, por ejemplo, cambiar el importe o los ítems de factura, agregar una descripción o metadatos y más.

Después de la hora inicial, ya no podrás hacer actualizaciones. Stripe envía la factura por correo electrónico al cliente para cobrar el pago de la suscripción.

Personaliza las facturas

Puedes personalizar facturas de varias maneras, lo que incluye:

Agregar ítems de factura adicionales a una factura futura
Aumentar la frecuencia de las facturas
Agregar ítems de factura a la primera factura de un cliente
Agregar ítems al borrador de una factura de suscripción
Generar una factura fuera del ciclo de suscripción
Suspender la factura de una suscripción para revisarla
Emitir una factura de suscripción con precios de ítems configurables

Agregar ítems de factura adicionales a una factura futura

En una factura, puedes agregar hasta 250 partidas de factura. Para agregar otras partidas de factura a la próxima factura del ciclo:

Estos ítems puntuales se agregan a la próxima factura creada para el cliente. Para cerciorarse de que se agregarán a una determinada suscripción, usa el parámetro opcional subscription para aplicarlos a esa suscripción.

Facturar ítems pendientes con más frecuencia

Aparte de cambiar el ciclo de cobro, existen algunas formas de facturar esas partidas sin ajustar el ciclo de suscripción normal:

Crea una factura puntual para el cliente.
Cobra la suscripción cada vez que el importe adeudado alcance un umbral.
Usa pending_invoice_item_interval para especificar con qué frecuencia se facturarán las partidas de factura pendientes. Esto equivale a hacer que Stripe cree una factura puntual para la suscripción de forma recurrente.

Agrega un cargo adicional a la primera factura de una suscripción

Incluye un cargo único en la primera factura de la suscripción usando add_invoice_items:

Precaución

Si usas Checkout para crear suscripciones, agrega cargos adicionales especificando line_items con la integración de cliente y de servidor.

Agregar ítems al borrador de una factura de suscripción

Cuando una suscripción se renueva y se crea una factura, Stripe envía el evento de webhook invoice.created. Stripe espera aproximadamente una hora antes de finalizar la factura e intentar el pago o enviar un correo electrónico.

Durante la espera, la factura está en estado borrador y es editable. Puedes crear partidas de factura para esa factura. Asegúrate de proporcionar el parámetro invoice al crear estas partidas de factura. De lo contrario, se agregan como partidas pendientes y se incluyen en el siguiente período de suscripción.

Estos ítems de factura se comportan de una forma un poco diferente de los ítems de factura generados automáticamente por Stripe:

Los ítems de factura pendientes siempre se cobran cuando finaliza el período de facturación de la suscripción que se cancela. Cancelar la suscripción de un cliente evita que se le facture otra vez si no hay ítems de factura.
Los ítems de factura pendientes no se prorratean si se modifica la suscripción de un cliente.

Si existen ítems de factura pendientes después de cancelar una suscripción, Stripe genera una factura e intenta facturarle al cliente estos ítems al final del siguiente período de facturación. Estos ítems de factura tampoco se prorratean si la suscripción se modifica.

Gestionar ítems de factura pendientes

Puedes ver los ítems de factura pendientes de un cliente en la página Clientes, haciendo click en su nombre. Si el cliente tiene un ítem de factura pendiente, aparecerá debajo de Ítems de factura pendientes. Un ítem de factura está pendiente si no está asociado a ninguna factura.

En Ítems de factura pendientes también puedes crear un ítem nuevo o facturar de inmediato todos los ítems enumerados. Al hacer click en Facturar ahora, aparece un cuadro de diálogo que te permite seleccionar si quieres cobrarle a la fuente predeterminada o enviarle la factura al cliente por correo electrónico. Además, el cuadro de diálogo te da la opción de calcular los impuestos automáticamente.

Generar una factura para ítems de suscripción fuera del ciclo de facturación

Puedes facturar las partidas de factura pendientes fuera del ciclo normal de cobro. Para ello, genera una factura puntual. La factura puntual generada incorpora las partidas de factura pendientes que se hubieran agregado a la próxima factura de la programación normal.

Precaución

Cuando generas una factura manualmente, Stripe no aplica las tasas impositivas que puedes haber establecido en la suscripción. Si se deben aplicar impuestos, debes agregar las tasas impositivas a la factura de manera expresa.

Suspender la factura de una suscripción para revisarla

En lugar de intentar el pago al final del período de facturación automáticamente, puedes suspender la factura para hacer revisiones o correcciones. Para suspender la factura:

Suspende el cobro automático dentro de la hora posterior a recibir el evento invoice.created. Puedes hacerlo estableciendo el parámetro auto_advance=false en la API o haciendo click en Suscripciones y correos electrónicos en el Dashboard. Una vez que encuentres la sección de suspensión de cobros, haz click en Configurar para aplicar los cambios. Esta funcionalidad impide que Stripe intente de manera automática el pago del cliente por el importe de la factura y que la envíe por correo electrónico.
Revisa la factura.
Una vez que tengas todo listo para cobrarle al cliente, reanuda el cobro automático. Para hacerlo, establece auto_advance=true o actualiza las opciones de suspensión de cobros en el Dashboard.

Emitir una factura de suscripción con precios de ítems configurables

Puedes emitir facturas con precios de ítem de factura que no incluyan los impuestos. Los precios con impuestos no incluidos solo se muestran en la factura en PDF. Es decir que, al usar impuestos incluidos, la página alojada de facturas y las facturas enviadas por correo electrónico mostrarán los precios con impuestos incluidos. Puedes configurar los precios netos en el Dashboard o mediante la API.

Incluir impuestos: La factura en PDF muestra los precios de los ítems de factura más el impuesto incluido. (Esta es la opción predeterminada).
Excluir impuestos: La factura en PDF muestra los precios de los ítems de factura sin contar los impuestos.

Prioridad de los pedidos

Si configuras un precio predeterminado para los precios de ítems de facturas de los clientes, estos tienen prioridad sobre los ajustes de la cuenta.

Anular una factura generada por una suscripción

Anular la primera factura de una suscripción

Cuando anula la primera factura de una suscripción, Stripe aplica la siguiente lógica establecida en el estado de la suscripción:

Si la suscripción está incompleta, el estado de la suscripción cambia a incompleta_expirada.
Si la suscripción está vencida, el estado de la suscripción cambia a activa.
Si la suscripción está activa, el estado de la suscripción no cambia.

Anular la factura más reciente de una suscripción

Cuando anula la factura más reciente de una suscripción activa, y la factura no es la primera, Stripe aplica la siguiente lógica a cada factura, empezando de la más reciente a la más antigua, hasta que cumpla una de las siguientes condiciones:

Si la factura se encuentra en estado pagada o incobrable, el estado de la suscripción cambia a activa.
Si el método_de_cobro está establecido en carga_automaticamente en la factura y Stripe ha dejado de reclamar la factura debido a los límites de reintentos, el estado de la suscripción cambia a canceleda, no pagada o vencida en función de su configuración de cobro automático.
Si el método_de_cobro está configurado como enviar_factura, y la factura está vencida, el estado de la suscripción cambia a vencida.
Si la factura no se encuentra en uno de estos estados, se ejecutan los mismos pasos en la siguiente factura más reciente.

Si ninguna factura coincide con alguno de estos criterios, el estado de la suscripción cambia a activa.

Metadatos de la suscripción

Después de que una suscripción crea una factura, en esta se incluyen los metadata de la suscripción de las siguientes maneras:

El atributo subscription_details.metadata de la factura siempre contiene los metadata de la suscripción en el momento de la creación de la factura, incluso si los metadata de la suscripción se modifican posteriormente.
El atributo metadata de las partidas de factura con type=“subscription” refleja los metadata de la suscripción más recientes en el momento de recuperar la factura. Esto significa que podría diferir de los metadata en el momento de la creación de la factura.
Las partidas de factura con type=“invoiceitem” no contienen los metadata de la suscripción.

Cuando modificas directamente los metadata de una partida de factura de la suscripción, ya sea con el punto de conexión de la actualización de la partida de factura o de la actualización masiva de partidas de factura, la solicitud de actualización declara los metadata de la partida de factura. Los 'metadata de las suscripciones «heredadas» no se conservan de manera implícita.

El valor Subscription item metadata no se propaga automáticamente a ningún otro objeto de Stripe.