Estados de suscripción e historial de facturación

Qué significa el estado de suscripción en Booknetic SaaS

En Booknetic SaaS, cada inquilino en su plataforma tiene un estado de suscripción — una etiqueta corta que le indica, de un vistazo, cuál es su situación financiera: si están en prueba, si le pagan de forma recurrente, si cancelaron, si su acceso expiró, o si aún no han terminado de registrarse.

El estado de suscripción es la columna más útil en su lista de Tenants. Es la forma en que detectas clientes que abandonan, encuentras usuarios en prueba que nunca se convirtieron y confirmas que sus inquilinos que pagan están realmente al día.

Algunas cosas que vale la pena saber desde el principio:

• El estado de suscripción se calcula, no se almacena como un solo enum. Booknetic SaaS guarda un pequeño registro por cada inquilino — qué plan tienen, cuándo termina su acceso, si tienen una suscripción activa con su proveedor de pagos, y si su correo electrónico está verificado. La etiqueta que ve ("Subscribed", "Expired", etc.) se deriva de esos campos cada vez que abre la lista Tenants.
• Su proveedor de pagos es la fuente de verdad del dinero. Booknetic SaaS refleja suficiente información del estado para controlar el acceso y mostrar quién ha pagado — pero Stripe, PayPal y WooCommerce guardan el registro completo de facturas, reembolsos e intentos de cobro de su lado. Cubriremos esto con detalle en la sección "Qué se almacena en Booknetic SaaS vs lo que vive con su proveedor" más abajo.
• Los cambios de estado son impulsados por eventos. Cuando un inquilino se suscribe, renueva, cancela o expira, el cambio se transmite a través de un webhook de su proveedor a Booknetic SaaS. Si el webhook no está correctamente configurado, Booknetic SaaS puede desincronizarse con la realidad — consulte Configuración del webhook Stripe para la causa más común de desajuste.

Los estados que verá en la lista Tenants

Booknetic SaaS muestra cuatro etiquetas de estado en su lista Tenants. Esto es lo que cada una significa en palabras simples y qué suele estar pasando con el inquilino cuando la ves.

Etiqueta de estado

Qué significa

Situación típica

Subscribed

El inquilino tiene una suscripción activa con su proveedor de pagos, y su acceso aún no ha expirado.

Le están pagando en ciclos mensuales o anuales, o están financiados por su saldo de depósito y tienen suficiente balance para seguir renovando.

Expired

El inquilino tiene (o tuvo) una suscripción con su proveedor, pero su período de acceso ha pasado y no se realizó ningún pago de renovación.

Un pago de renovación falló, el inquilino canceló y el período pagado se terminó, o una prueba terminó sin una actualización.

Not activated

El inquilino se registró pero nunca verificó su correo electrónico.

Comenzaron el formulario de registro, nunca hicieron clic en el enlace de verificación y actualmente no pueden acceder a su panel de inquilino.

Not subscribed

El inquilino verificó su correo electrónico pero no tiene suscripción activa.

Un inquilino cuya suscripción fue cancelada y el periodo de pago también ha terminado, o cualquier otro estado donde ya haya pasado la prueba pero no haya pagado.

Una quinta etiqueta de la que sueles oír hablar — Trial — es un caso especial de "Subscribed": el inquilino está en el Plan Trial que configurate en Booknetic SaaS → Settings → Plan Settings, su ventana de acceso es la ventana de duración del juicio que establezcas y aún no ha pagado. La lista de Tenants muestra a los inquilinos de prueba bajo la misma etiqueta Subscribed hasta que expire su prueba; una vez aprobado, pasan a Expired. Para el flujo completo del juicio, véase Juicios en Booknetic SaaS.

Importante: Booknetic SaaS no tiene la etiqueta de "Pausado", "Past due" o "proceso de reclamación de pagos". Si su proveedor de pagos pone una suscripción en proceso de reclamación de pagos (Stripe past_due, PayPal reintento) y la renovación aún no ha tenido éxito o ha fallado definitivamente, Booknetic SaaS seguirá mostrando al inquilino como Subscribed hasta que la renovación tenga éxito (extienda el periodo) o la suscripción se cancele por completo. Para tener visibilidad sobre los proceso de reclamación de pagos a bordo, consulte directamente sus Stripe Dashboard → Suscripciones o PayPal → Actividad.

Cómo un inquilino se mueve entre estados

Los inquilinos se mueven entre estados según los eventos que ocurren al registrarse, en su página de Billing o — más comúnmente — en su proveedor de pagos cuando se activa un webhook.

La tabla de abajo traza el estado en el que estaban, el evento que ocurrió y el estado en el que acabaron. Esta es la imagen completa de cómo cambia el estado de la suscripción en su plataforma.

Del estado

Evento

Declarar

De dónde surge el evento

(nuevo registro)

El inquilino envía el formulario de inscripción, correo electrónico aún no verificado

Not activated

Booknetic SaaS flujo de inscripción

Not activated

El inquilino hace clic en el enlace de verificación por correo electrónico

Subscribed (en plan de prueba, si configurate una prueba) o Not subscribed (si no hay prueba)

Booknetic SaaS Flujo de verificación

Subscribed (prueba)

El inquilino elija un plan de pago en Billing y paga

Subscribed (en plan de pago)

Página Billing del inquilino → Stripe / PayPal / saldo

Subscribed (prueba)

La duración de la prueba pasa sin mejora

Expired

Basado en tiempo, sin necesidad de eventos

Subscribed (de pago)

Renovación exitosa

Subscribed (periodo extendido)

Webhook: Stripe invoice.paid / PayPal PAYMENT.SALE.COMPLETED

Subscribed (de pago)

Los inquilinos hacen clic Cancel subscription en su página de Billing

Subscribed hasta que termine el periodo, luego Expired

Acción → cancelación del inquilino enviados al proveedor

Subscribed (de pago)

El propietario cancela mediante administración SaaS o mediante el Panel de Control del proveedor

Subscribed hasta que termine el periodo, luego Expired

Acción → cancelación del propietario enviadas al proveedor

Subscribed (de pago)

El pago de renovación falla y el proceso de reclamación de pagos del proveedor se rinde

Expired

Webhook: Stripe customer.subscription.deleted / PayPal BILLING.SUBSCRIPTION.CANCELLED

Subscribed (de pago)

Plan de cambio de inquilino (actualización/degradación)

Subscribed (en nuevo plan, nuevo periodo)

Página de Billing del inquilino → nuevo pago confirmado

Expired

El inquilino vuelve y se suscribe de nuevo desde Billing

Subscribed (en el plan elegido)

Página Billing del inquilino → Stripe / PayPal / saldo

Expired / Not subscribed

El propietario adelanta manualmente la fecha de caducidad en Tenants → Editar

Subscribed hasta la nueva fecha de vencimiento

Anulación del manual del propietario (usada para extensiones de goodwill)

Detalle importante sobre la cancelación: hacer clic Cancel subscription no revoca el acceso inmediatamente. Detiene el siguiente cargo recurrente: su inquilino mantiene el acceso hasta el final del periodo que pagó por última vez y solo cambia a Expired una vez que ese límite de periodo pasa. Lo mismo ocurre con una cancelación iniciada por el propietario. Para el flujo completo de cancelación, véase Cancelación y eliminación de inquilinos.

Lo que se almacena en Booknetic SaaS frente a lo que vive con su proveedor

Esta es la sección más importante de este documento, y es la sección que la mayoría de propietarios leen después de haber prometido a un cliente algo Booknetic SaaS no puede cumplir. Léelo antes de que llea el correo del cliente, no después.

Booknetic SaaS es un delgado reflejo del estado. Su proveedor de pagos — Stripe, PayPal o WooCommerce — es la fuente de verdad por el dinero. Eso tiene consecuencias prácticas sobre lo que puede mostrar a sus inquilinos, lo que puede exportar y lo que ocurre cuando las cosas van mal.

Aquí va la parte honesta.

Qué guarda Booknetic SaaS localmente en su sitio de WordPress

Para cada inquilino, Booknetic SaaS lleva un pequeño registro:

• En qué plan están.
• Cuando termina su acceso actual (la fecha Expira que ves en la página de Billing del inquilino).
• Si tienen una suscripción en producción con su proveedor de pago y un ID de referencia para esa suscripción.
• Su saldo de depósito, si ha activado el WooCommerce de recarga.
• Si han verificado su correo de registro.

Y para cada evento de facturación significativo, Booknetic SaaS añade una fila al historial de facturación de ese inquilino:

• La fecha del evento.
• La cantidad.
• El método de pago utilizado (tarjeta de crédito mediante Stripe, PayPal o saldo).
• El estado (pagado, cancelado, etc.).
• Un identificador para cruzar con su proveedor de pagos.

Eso es todo. Es suficiente para alimentar sus vistas de administrador, acceder a los inquilinos de puerta en los momentos justos y mantener un registro por el que puedas desplazarte. No es suficiente para ser su sistema contable.

¿Qué vive con Stripe (cuando su inquilino paga con Stripe)

Cuando un inquilino le paga a través de Stripe Checkout, Stripe se queda:

• El registro completo de suscripción (periodo actual, fecha de próxima renovación, historial completo).
• Cada factura — pagada, impagada, anulada, reembolsada — en formato PDF descargable.
• IDs de intención de pago y el detalle subyacente de la tarjeta (PCI-scope — Booknetic SaaS nunca ve el número de la tarjeta).
• Registros de reembolsos, incluyendo reembolsos parciales e historial de disputas.
• Intentos de proceso de reclamación de pagos (Stripe Smart Retries) y el resultado de cada intento de nuevo.
• El correo electrónico archivado del inquilino en Stripe, utilizado para la entrega de recibos.

Cualquier cosa que necesite un PDF, un detalle de reembolso, un registro de devolución de cargo o una actualización de tarjeta en archivo ocurre en su Stripe Dashboard, no en Booknetic SaaS. Reflejamos lo suficiente el estado de la suscripción como para saber "sí, se pagan hasta esta fecha" — no reflejamos el detalle financiero.

¿Qué vive con PayPal (cuando su inquilino paga con PayPal)

PayPal almacena el Billing Acuerdo — el contrato de pagos recurrentes con su inquilino — más todas las transacciones bajo ese acuerdo:

• El estado del acuerdo (Activo, Suspendido, Cancelado).
• Cada registro de PAYMENT.SALE (pago renovado).
• Los datos del lado PayPal del pagador.
• Registros de reembolsos por parte de PayPal.

Cuando hace clic en Cancel subscription en Booknetic SaaS para un inquilino pagado PayPal, Booknetic pide PayPal que suspendas el acuerdo (no lo rescindas). El acuerdo sigue vigente en PayPal y leóricamente es reanudado por parte de PayPal. Para la salida legal (terminación total del acuerdo), hazlo desde su PayPal Dashboard.

¿Qué se mantiene con WooCommerce (cuando sus inquilinos recargan con la fianza)

Si ha activado el WooCommerce de depósito/saldo, el libro de registros está en WooCommerce:

• Cada pedido de WooCommerce que financió el depósito de un inquilino (con el método de pago de la WooCommerce — Stripe para WooCommerce, transferencia bancaria, COD, cualquier cosa que la WooCommerce).
• El registro de clientes de WC para el inquilino.
• Los propios registros de reembolso de WC en las órdenes de depósito.

Booknetic SaaS solo almacena el saldo resultante de cada inquilino. Si reembolsa una orden de depósito de WooCommerce en su administrador de WC, Booknetic SaaS no resta automáticamente del saldo del inquilino — tendrá que ajustar el saldo manualmente en Booknetic SaaS → Tenants → Edit.

La única regla que mantiene esto manejable

Si un cliente le pide cualquier cosa que implique un número, un PDF o un registro de reembolso, la respuesta suele ser:

1. Booknetic SaaS le muestra el estado (suscrito / caducado, fecha de finalización del periodo, plan actual, método de pago utilizado).
2. Stripe / PayPal / WooCommerce le muestra el detalle (el PDF de la factura, el registro de reembolso, la disputa, la tarjeta archivada).

Los propietarios que tratan Booknetic SaaS como su columna vertebral contable pierden mucho tiempo en problemas de conciliación fantasma. Los propietarios que lo tratan como un reflejo del estado proveedor, y Stripe / PayPal / WC como el libro mayor autorizado, lo tienen mucho más fácil.

Cómo encontrar el historial de facturación de un inquilino

El historial de facturación del lado del propietario está dentro del administrador SaaS, en la vista por inquilino.

1. Abra WP admin → Booknetic SaaS → Tenants.
2. Encontrar la fila de inquilinos.
3. Haga clic en el menú de acciones de la fila (el menú de tres puntos al final de la fila) y elija Historial de pagos.

La vista de historial de pagos muestra todos los eventos de facturación de ese inquilino: pago recibido, suscripción cancelada, saldo depositado. Cada fila muestra:

• La fecha del evento.
• La cantidad.
• El plan implicado.
• El método de pago (tarjeta vía Stripe, PayPal o saldo).
• El estado del evento.
• Un identificador de referencia que puede cruzar con su proveedor.

Desde la perspectiva del inquilino, la misma información aparece en su propio panel de Booknetic — abra Billing dentro de su administrador de inquilinos y se desplaza hasta la sección de Billing historia debajo de la cuadrícula de la tarjeta de planos.

Lo que esta vista no muestra. La vista de historial de pagos en el administrador SaaS no muestra: PDFs de facturas, detalles de reembolso, historial de reintentos de proceso de reclamación de pagos o la tarjeta archivada. Para cualquiera de esos, abra el registro correspondiente Stripe / PayPal / WC usando el identificador de referencia de la fila Booknetic.

Dónde encontrar la próxima fecha de renovación de un inquilino

Dos sitios, con la misma respuesta pero con ergonomía diferente.

Desde la perspectiva del inquilino — Billing → Plan actual

Cuando el inquilino abra su modal Billing → Plan actual, el campo Caduca en muestra la fecha en que finaliza su acceso actual. Para un inquilino con suscripción recurrente, esa también es la fecha en que se ejecutará su próxima renovación.

Desde la perspectiva del propietario — Tenants → fila de inquilinos

La lista de Tenants muestra la fecha de caducidad de cada inquilino en la columna Caduca en. Para un inquilino con suscripción Stripe o PayPal, esa es la fecha en la que el proveedor intentará el próximo pago de renovación.

Para la visión más completa de una renovación próxima — cantidad exacta, comportamiento de reintento programado si la tarjeta falla, etc. — vaya a su Stripe Dashboard → Clientes → [el inquilino] → Suscripciones o PayPal → Actividad → Pagos recurrentes. Stripe y PayPal tienen una imagen mucho más detallada de "lo que pasa después" que Booknetic SaaS.

Nota sobre la sincronización. La fecha de Expira en del inquilino y el momento real en que se corta el acceso se basan en la zona horaria de su servidor WordPress. Para la mayoría de las configuraciones, esto no importa: la renovación ocurre en el mismo instante en que termina el período, y su inquilino no lo notará. Si necesita una sincronización precisa entre zonas horarias (por ejemplo, para clientes internacionales), confirme la zona horaria de su sitio WordPress en WP Admin → Settings → General → Zona horaria y pruebe con un inquilino sandbox.

Flujo de trabajo del propietario: ver todos sus inquilinos que pagan este mes

No existe un filtro incorporado de "inquilinos que pagan este mes" en Booknetic SaaS, pero puede armar la vista desde dos pantallas.

Desde Booknetic SaaS

1. Abra WP Admin → Booknetic SaaS → Tenants.
2. Filtre la lista por estado Subscribed.
3. Ordene por la columna Expira en para ver quién está próximo a la renovación y quién tiene una renovación reciente detrás.

Esto le da el conjunto de inquilinos que actualmente están en un plan pago. No muestra los montos en dólares por inquilino; para eso, consulte el historial de pagos de cada inquilino.

Desde Stripe / PayPal

Para la vista de ingresos en el mismo período:

• Stripe Dashboard → Pagos (o Suscripciones → Todas las suscripciones filtradas por estado Active) — le da la lista de suscripciones activas, totales del período actual, MRR y tendencias de ingresos.
• PayPal → Actividad → Todas las transacciones filtradas por fecha y tipo (pago recurrente) — le da el equivalente para sus inquilinos que pagan con PayPal.

Los paneles de control del proveedor son donde realmente vive su vista contable. Booknetic SaaS le da la asociación a nivel de inquilino ("este inquilino es quien le está pagando"); el proveedor le da los totales a nivel de transacción.

Flujo de trabajo del propietario: exportar datos de facturación para contabilidad

Booknetic SaaS no incluye actualmente un botón nativo de "Exportar historial de facturación" en las pantallas de Tenants o Historial de pagos. No hay exportación CSV / Excel incorporada desde dentro del administrador del SaaS.

Esa es la respuesta honesta. Aquí le mostramos cómo obtener sus datos contables de todos modos.

Opción 1 — Exportar desde su proveedor de pagos

Este es el camino recomendado porque el proveedor ya tiene todo el registro.

• Stripe: abra Stripe Dashboard → Pagos (o Clientes, o Suscripciones), establece el rango de fechas, haga clic en Exportar en la parte superior derecha y descarga el CSV. La exportación de Stripe incluye IDs de factura, correo electrónico del cliente, montos en su moneda, comisiones y montos netos: todo lo que realmente necesita su contable.
• PayPal: abra PayPal → Actividad → Todas las transacciones, establece el rango de fechas, haga clic en Descargar y elija el formato CSV o PDF.
• WooCommerce (para volumen de depósitos/recargas): WooCommerce tiene su propia ruta Pedidos → Exportar, o puede usar cualquier extensión de exportación CSV de WooCommerce. Los pedidos de WC que financian depósitos de inquilinos están marcados con el ítem de línea de depósito Booknetic.

Opción 2 — Vincule Booknetic SaaS con su registro de proveedor

Si específicamente necesita saber a qué inquilino corresponde cada transacción del proveedor, use la columna identificador de referencia en Tenants → inquilino → Historial de pagos para cotejar con el ID Stripe subscription o el PayPal agreement_id en la exportación del proveedor. Este es un paso manual, pero es la única manera de unir la identidad a nivel de inquilino (en Booknetic SaaS) con el detalle financiero a nivel de transacciones (en su proveedor).

Lo que no recomendamos

• Extraer manualmente la vista del historial de pagos del administrador SaaS a una hoja de cálculo: es preciso, pero lento y, de cualquier manera, perderás registros de reembolsos y detalles de cobros pendientes. La exportación del proveedor es más rápida y completa.
• Construir cualquier cosa que dependa de que Booknetic SaaS sea su única fuente contable. Como se explicó arriba, Booknetic SaaS solo refleja una pequeña porción del estado.

Una nota para comentarios del producto. Una exportación CSV incorporada del historial de facturación de inquilinos es una solicitud frecuente de los clientes. Si esto le desbloquearía, infórmanos a través de los canales estándar de comentarios del producto: está en el radar del equipo.

Preguntas comunes

¿Dónde puedo ver cuándo será la próxima renovación de mi inquilino? La fecha Expira en en el modal Billing → Plan actual del inquilino es la respuesta más accesible para el inquilino; la columna Expira el en su lista Tenants es el equivalente para ti. Para la perspectiva del proveedor (monto exacto, comportamiento de reintento, cobros pendientes en curso), ve directamente a su cuenta de Stripe Dashboard o PayPal.

¿Puedo exportar el historial de facturación a CSV? No directamente desde Booknetic SaaS: no hay un botón nativo de exportación CSV en la pantalla de Tenants o Historial de pagos. La ruta estándar es exportar desde el Panel de su proveedor de pagos (Stripe Dashboard → Pagos → Exportar, o PayPal Actividad → Descargar), y cotejar con el identificador de referencia del inquilino en Booknetic SaaS si necesita atribuir ingresos a inquilinos específicos.

¿Qué pasa si reembolso una factura en Stripe — Booknetic SaaS lo sabe? No. Booknetic SaaS no actualice automáticamente el estado de suscripción de un inquilino cuando emites un reembolso en Stripe (o PayPal, o WooCommerce). El inquilino seguirá apareciendo como Subscribed con la misma fecha de Caducidad hasta que lo ajustes manualmente. Si un reembolso forma parte de una cancelación, la solución estándar es abrir Booknetic SaaS → Tenants → Edit en el inquilino, poner su Expira para una fecha anterior (normalmente hoy) y guardar. Si el reembolso es parcial y tenías la intención de que el inquilino perdiera parte de su periodo — se aplica la misma edición; Solo pon la fecha en la que quiere que termine su acceso. Esta es una laguna conocida y es candidata para una futura actualización del producto; Por ahora, mantén el hábito de reflejar manualmente las acciones de reembolso.

¿Por qué mi inquilino muestra "Subscribed" en Booknetic SaaS pero Stripe dice "past_due"? Porque Booknetic SaaS no tiene un estado propio de "past_due" o "proceso de reclamación de pagos" — solo cambia a Expired cuando Stripe se rinde completamente y despide customer.subscription.deleted (o cuando el límite del periodo pasa sin una renovación exitosa). Mientras Stripe sigue intentando de nuevo la tarjeta con Smart Retries, Booknetic SaaS seguirá mostrando al inquilino como Subscribed. Dos cosas a comprobar:

1. El webhook está en buen estado. Si su webhook Stripe está mal configurado (secreto incorrecto, URL incorrecta, fallo de firma), no Booknetic SaaS sabrá de la cancelación eventual cuando Stripe se rinda — y el inquilino permanecerá "Subscribed" para siempre, por error. Verifica su configuración de webhook en Configuración del webhook Stripe. Esta es la causa más común de "Booknetic y Stripe discrepan".
2. Su proveedor es la verdad. Mientras el proceso de reclamación de pagos está en vuelo, la verdad está en Stripe, no en Booknetic SaaS. Si necesita actuar sobre el estado de proceso de reclamación de pagos — por ejemplo, enviar un correo al inquilino con un mensaje de "tarjeta fallida" — léelo desde su Stripe Dashboard.

¿Puedo ver los reembolsos en el historial de facturación Booknetic SaaS? No — los reembolsos emitidos en Stripe, PayPal o WooCommerce no aparecen en la vista de historial de pagos dentro de Booknetic SaaS. El registro de Booknetic solo registra los eventos recibidos por pago, cancelación de suscripción y acreditados por depósito. Para visibilidad de los reembolsos, utiliza el Panel de Control de su proveedor.

Mi inquilino canceló — ¿cuándo termina realmente su acceso? Al final del periodo por el que pagó por última vez, no inmediatamente. Booknetic SaaS sigue mostrando al inquilino como Subscribed hasta el final de su periodo de pago, y luego lo cambia a Expired cuando pasa el límite del periodo. Esto se aplica tanto a las cancelaciones iniciadas por inquilinos como por el propietario, tanto en Stripe como en PayPal. Para el flujo completo de cancelación (y el patrón de cancelar primero, luego verificar en proveedor y, opcionalmente, eliminar), véase Cancelación y eliminación de inquilinos.

¿Cuál es la diferencia entre "Expired" y "Not subscribed"? Expired significa que el inquilino tenía una suscripción (prueba gratuita, pagada o financiada con saldo) y la ventana de acceso se agotó. Not subscribed significa que el inquilino verificó su correo electrónico, existe como inquilino, pero nunca tuvo una suscripción — o, más raramente, tuvo una que completó completamente su ciclo de cancelación hace tanto tiempo que incluso el periodo de pago posterior a la cancelación ya ha terminado. Por experiencia del inquilino, ambos estados se sienten similares: alcanzan los límites de planes caducados de Booknetic SaaS y pueden recuperarse eligiendo un plan en su página de Billing.

Tengo que saber

El webhook es el mecanismo de sincronización — manténgalo en buen estado

Casi todos los tickets de soporte de "Booknetic SaaS y mi proveedor no están de acuerdo" se remontan a un webhook mal configurado. Si su Stripe secreto del webhook está vacío, incorrecto o apunta al punto final equivocado, las renovaciones no actualizarán silenciosamente la fecha de caducidad del inquilino — aunque Stripe esté cargando la tarjeta con gusto. Lo mismo para PayPal: si el paypal_webhook_id no está configurado, los eventos de PAYMENT.SALE.COMPLETED se rechazan y Booknetic SaaS nunca extiende la fecha de caducidad.

Si sus inquilinos están pagando pero sus fechas de caducidad en no se están moviendo, el webhook es el primer lugar donde buscar. Consulte Configuración del webhook Stripe para la guía completa de configuración y resolución de problemas.

Booknetic SaaS no concilia reembolsos — usted debe hacerlo

Ya hemos tratado esto arriba; Merece la pena repetirlo porque es el tema más común de la reconciliación. Un reembolso emitido en Stripe, PayPal o WooCommerce no se propaga de nuevo a Booknetic SaaS. Si un reembolso también revoca el acceso, tiene que reflejar ese cambio en Tenants → Editar → Caduca en. Incorpora esto a su flujo de trabajo de reembolso como hábito: su yo del futuro le lo agradecerá.

Cancelar en el proveedor no siempre se actualice Booknetic SaaS instantáneamente

Si cancelas una suscripción directamente desde el Panel de Stripe o PayPal (en lugar de a través de Booknetic SaaS), la cancelación se propaga de vuelta a Booknetic SaaS vía el webhook — eventualmente. Pero si el webhook no está correctamente configurado, el inquilino seguirá apareciendo como Subscribed en Booknetic SaaS hasta que pase la fecha original de Expires on. Cancelar a través de Booknetic SaaS (Billing del inquilino → Cancel subscription, o su equivalente en el lado del propietario) suele ser la manera más limpia porque activa tanto la cancelación del proveedor como la actualización del estado local al mismo tiempo.

Los inquilinos financiados por Balance se comportan de manera ligeramente diferente

Si un inquilino le paga mediante el depósito/saldo de WooCommerce, sus renovaciones se financian deduciendo de su saldo almacenado en lugar de cobrar una tarjeta. Mientras su saldo cubra el monto del siguiente ciclo, Booknetic SaaS deduce automáticamente y extiende la fecha de Expira en — sin que intervenga un webhook del proveedor. El historial de facturación del inquilino mostrará la deducción de la misma manera que se muestra un pago de Stripe o PayPal. La advertencia: si se acaba el saldo, la siguiente "renovación" simplemente no ocurrirá, y el inquilino pasará a Expired en el siguiente límite del período. No hay recarga automática desde un método de pago.

Las facturas Stripe emitidas manualmente no extienden el acceso

Si emites una factura única directamente en su Stripe Dashboard (por ejemplo, una mejora anual manual o una factura por trato especial), y el inquilino la paga, el webhook correspondiente de Stripe llega a Booknetic SaaS — pero está marcado como un evento de facturación manual y no extiende la fecha de vencimiento del inquilino. Para honrar esa factura manual en Booknetic SaaS, debe actualizar tú mismo la fecha de Expira en del inquilino en Tenants → Editar.

A dónde ir a continuación

• Lee Trials in Booknetic SaaS para tener una visión completa de cómo un inquilino de prueba se convierte en un inquilino de pago: esa es la transición más importante en su plataforma.
• Lee Plans y capacidades de los planes para diseñar los planes a los que el estado de suscripción realmente se asigna: las capacidades y los límites son lo que cambia cuando un inquilino pasa de un estado a otro.
• Lee Cancelar y eliminar inquilinos para conocer el orden seguro para cancelar una suscripción, verificar la cancelación con su proveedor y solo entonces (si es necesario) eliminar el registro del inquilino.
• Lee Configuración del webhook Stripe: la salud del webhook es el mayor determinante de si Booknetic SaaS y su proveedor se mantienen sincronizados.
• Lee Facturación de suscripción Stripe en Booknetic SaaS para obtener la referencia más amplia sobre facturación en Stripe, incluyendo cobros pendientes, reembolsos y la frontera entre modo de prueba y modo en producción.

Revision 2026-05-30: TASK-3211 link prefix correction; draft-side only, no Marketing API call.