Facturas de suscripciones
Las facturas son recursos básicos en Stripe, que representan la cantidad adeudada por un cliente. Stripe genera una factura por cada período del ciclo de facturación de suscripción. También puede generar facturas manualmente a través del Dashboard o la API para pagos fuera de ciclo o por única vez. Lee las guías para obtener 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 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.
Si el pago se efectúa con éxito 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 estado de la factura es open
y auto_advance permanece en false
. El estado de la suscripción es incomplete
. Aprende a resolver los errores de pago de las facturas de suscripciones nuevas que exigen un método de pago.
In some cases, upgrading or downgrading the subscription also creates a new invoice. We turn off auto_advance for these invoices from the outset.
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.
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.Attempts to finalize and pay the invoice with the default payment method.
Cambia el estado de la factura a
paid
si el pago se efectúa con éxito.
When Stripe creates an invoice, you receive—through configured webhooks—an invoice.created
event. In this case, the attribute of the invoice status is draft
, which means that its invoice items are open for modification.
Cobrar pagos
Cuando vence una factura, Stripe intenta cobrar el pago mediante un cargo automático al método de pago guardado o el envío de la factura por correo electrónico a los clientes.
Reintentar pagos
Stripe ofrece varias opciones para administrar los pagos fallidos, incluidos los reintentos inteligentes efectuados mediante machine learning.
Actualizar 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.
Personalizar facturas
You can customize invoices in several ways, including:
- Add extra items to a future invoice
- Aumentar la frecuencia de las facturas
- Agregar ítems de factura a la primera factura de un cliente
- Add items to a draft subscription invoice
- 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 ítems de factura. Para agregar otros ítems 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 facturación, existen algunas formas de facturar esos ítems 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 determinado.
Usa pending_invoice_item_interval para especificar con qué frecuencia se facturarán los ítems 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
If you’re using Checkout to create subscriptions, add extra charges by specifying line_items with the client and server integration.
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 draft
y es editable. Puedes crear ítems para esa factura. Al crear estos ítems de factura, debes proporcionar el parámetro invoice. De lo contrario, se agregarán como ítems pendientes y se incluirán 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.
Pending invoice items aren’t prorated when a customer’s subscription changes.
If pending invoice items remain after a subscription cancels, Stripe generates an invoice and attempts to bill the customer for them at the end of the next billing period. These invoice items are (similarly) not prorated when a subscription changes.
Manage pending invoice items
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 ítems de factura pendientes fuera del ciclo normal de facturación generando una factura puntual. La factura puntual generada incorpora los ítems 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ámetroauto_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, rehabilita el cobro automático. Puedes hacerlo estableciendo auto_advance=true o actualizando 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.
Order precedence
Si configuras un precio predeterminado para los precios de ítems de facturas de los clientes, estos tienen prioridad sobre los ajustes de la cuenta.
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 losmetadata
de la suscripción se modifican posteriormente. - El atributo metadatos 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 losmetadata
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.
Los metadatos de los ítems de suscripción no se propagan automáticamente a ningún otro objeto de Stripe.