Cómo funcionan las suscripciones

Con Subscriptions, los clientes acceden a un producto por el que hacen pagos recurrentes. Las suscripciones requieren que retengas más datos sobre los clientes que en las compras únicas, porque tienes que poder cobrarles en el futuro.

Stripe ofrece muchas funcionalidades que te ayudan a gestionar la facturación de suscripciones:

• Admisión de diferentes modelos de tarifas
• Gestión de descuentos en suscripciones
• Gestión de pruebas
• Prorrateos para suscripciones modificadas
• Gestión de autoservicio del cliente
• Facturación para el cobro de pagos
• Recuperación de ingresos automatizada
• Elaboración de informes y análisis

El ciclo de vida de la suscripción

Así se ve el flujo recomendado de suscripción:

1. Create the subscription. The status of the subscription is incomplete if you follow these steps. If you create a subscription without specifying the payment_behavior, the default status is active.

2. Stripe automatically creates an invoice with the open status for the subscription.

3. El cliente paga la primera factura.

4. Cuando el pago se efectúa correctamente:

   • El status de la suscripción pasa a active
   • El status de la factura se establece en paid
   • Stripe envía un evento de factura pagada (invoice.paid) a los puntos de conexión de webhooks configurados

5. Brindas acceso a tu producto. Para confirmar si la factura se pagó:

   • Configura un punto de conexión de webhook u otro tipo de destino de evento y escucha el evento de factura pagada (invoice.paid).
   • Marca manualmente el objeto de suscripción y busca subscription.status=active. El estado (status) pasa a activo (active) cuando se paga la factura, ya sea por cobro automático o por pago manual del cliente.

El campo del estado (status) pasa al período de prueba (trialing) si ofreces pruebas que no requieren pagos. Cuando finaliza la prueba, la suscripción pasa a activa (active) y se inicia el cobro al cliente suscrito.

Comportamiento del pago de la suscripción

Para simplificar la gestión de pagos fallidos, crea suscripciones con payment_behavior establecido como default_incomplete. Esto crea suscripciones con estado incomplete, lo que te permite recopilar y confirmar la información de pago en una sola interfaz de usuario. Al usar allow_incomplete o error_if_incomplete, Stripe intenta pagar la factura de inmediato. Si se produce un error en el pago, el estado de la suscripción cambiará a incomplete o no se creará la suscripción.

Pagos exitosos

Cuando tu cliente paga correctamente la factura, la suscripción pasa a activa (active) y la factura, a pagada (paid). En este punto, puedes brindar acceso a tu producto.

Período de pago

Los clientes tienen unas 23 horas para efectuar el pago correctamente. Durante este período, la suscripción permanece incompleta (incomplete) y la factura, abierta (open). Si el cliente paga la factura, la suscripción pasa a activa (active) y la factura, a pagada (paid). Si no efectúa ningún pago, la suscripción pasa a incompleta vencida (incomplete_expired) y la factura, a nula (void).

Este período existe porque el cliente suele hacer el primer pago de una suscripción durante la sesión. Si el cliente regresa a tu aplicación después de 23 horas, crea una nueva suscripción.

Pagos fallidos

Mientras los pagos automáticos se efectúen correctamente, el estado de la suscripción sigue siendo active. Si estos fallan, la suscripción se actualiza a past_due y Stripe intenta recuperar el pago según tus reglas de reintentos. Si la recuperación del pago falla, puedes cambiar el estado de la suscripción a canceled o unpaid, o puedes dejarlo como past_due.

Suscripciones impagas

En el caso de las suscripciones con facturas impagas, las facturas impagas permanecen abiertas, pero se suspenden los intentos de pago. La suscripción continúa generando facturas en cada ciclo de facturación, que permanecen en el estado draft. Para reactivar la suscripción:

1. Recopila nueva información de pago si es necesario.

2. Para habilitar el cobro automático, configura la propiedad auto_advance como verdadera (true) en los borradores de facturas.

3. Cierra y paga las facturas abiertas. Al pagar la factura no anulada más reciente antes de su fecha de vencimiento, el estado de la suscripción se actualiza a active.

Las facturas marcadas como incobrables se tratan como paid cuando se determina el estado de la suscripción, aunque su propiedad pagada siga siendo false. Stripe ignora las facturas anuladas al determinar el estado de la suscripción; en su lugar, se utiliza la factura no anulada más reciente.

El status de una suscripción impaga se basa en la configuración de pagos fallidos del Dashboard.

Cancela suscripciones

Si cancelas una suscripción, se deshabilitará la creación de nuevas facturas y se interrumpirá el cobro automático de todas las facturas en esa suscripción. Esto sucede porque dicha acción establece auto_advance en false. También se eliminará la suscripción y no podrás actualizar ni la suscripción ni sus metadatos. Si tu cliente quiere volver a suscribirse, tendrás que recopilar nuevos datos de pago y crear una suscripción nueva.

Modifica suscripciones

Stripe admite modificar suscripciones existentes sin tener que cancelarlas y volver a crearlas. Algunos de los cambios más importantes que puedes hacer son actualizar o rebajar el precio de la suscripción, o cancelar o pausar el cobro de una suscripción activa. Obtén más información sobre cómo modificar las suscripciones existentes.

Administrar Checkout Sessions

Para las integraciones de Stripe Checkout, no puedes actualizar la suscripción o su factura si la suscripción de la sesión está incomplete. Puedes escuchar el evento checkout.session.completed para realizar la actualización una vez finalizada la sesión.

También puedes dejar vencer la sesión si quieres cancelar la suscripción de la sesión, anular la factura de la suscripción o marcar la factura como incobrable.

Modelo de integración

En esta sección se describe nuestra integración de ejemplo en GitHub, que ilustra cómo crear una integración de suscripciones. Si estás listo para crear tu propia integración, consulta la guía de inicio rápido de Billing o la guía de integración.

Página de inicio

En el front-end, la página de inicio primero recopila la dirección de correo electrónico. Es posible que tu aplicación requiera que obtengas otros datos específicos del cliente, como un nombre de usuario o un domicilio. Al hacer click en el botón para crear una cuenta, los datos recopilados en la página de inicio se envían al back-end. Este proceso crea un nuevo cliente y abre la página de tarifas en el front-end.

Página de tarifas

La página de precios muestra tus opciones de suscripción en función de los productos y precios que creaste cuando configuraste tu integración por primera vez, lo que significa que no necesitas crear otras nuevas cada vez que los clientes se registren. Tu página de precios muestra los precios que creaste y tus clientes eligen la opción que desean. El ejemplo en GitHub muestra un formulario de pago cuando un cliente selecciona una opción. Obtén más información sobre los productos y los precios.

Pago

El formulario de pago recopila los datos de la tarjeta y un nombre. Si usas Checkout, este formulario está alojado en Stripe y es una de las funcionalidades clave que te permiten cobrar pagos y cumplir siempre con la normativa PCI. Al hacer click en Suscribirse:

1. Crea una nueva suscripción con los ID de precio y de cliente.
2. Genere una factura para su ciclo de suscripción inicial.
3. Recopila los datos de la tarjeta y paga la factura.
4. Establece el método de pago como predeterminado para la suscripción, lo cual es necesario para los próximos pagos.

Asegúrate de confirmar el pago antes de proporcionar acceso a tu cliente.

Para implementar esto:

• Acepta pagos sin necesidad de escribir ni una línea de código: Si no quieres escribir ningún código, aprende a crear un enlace de pago y compártelo con tus clientes.
• Crea una página de confirmación de compra: usa la API Checkout Sessions para aceptar pagos a través de una página alojada, un formulario integrado en tu sitio o una página de confirmación de compra personalizada creada con componentes integrados.
• Integración avanzada: usa Stripe Elements para recopilar los datos de pago y activar la suscripción con el Payment Element.

Cómo hacer el suministro

Usa Derechos para determinar cuándo puedes conceder o revocar el acceso a las funcionalidades del producto para tus clientes. Alternativamente, después de un pago exitoso, puedes aprovisionar el producto de manera segura para el cliente. Por lo general, esto significa:

1. Verificar que el estado de la suscripción sea active.
2. Otorgarle al cliente acceso a los productos y las funcionalidades a los que se suscribió.

Aprende a usar destinos de eventos para hacer lo siguiente:

• Hacer el seguimiento de suscripciones activas
• Gestionar errores de pago
• Comprobar objetos de evento

Cómo funcionan los pagos con las suscripciones

Para simplificar la gestión de pagos fallidos y crear suscripciones antes de intentar el pago:

1. Especifica payment_behavior=default_incomplete al crear una suscripción. Si esta requiere un pago, se crea con el estado incomplete; de lo contrario, la suscripción inmediatamente pasa al estado active.

2. Active una suscripción incompleta pagando la primera factura.

3. Especifica el identificador del Payment Intent de la factura en tu interfaz de usuario para recopilar información de pago y confirmar el Payment Intent. Puedes usar Elements, el SDK para Android o el SDK para iOS.

Cargos recurrentes

Stripe gestiona los cargos recurrentes automáticamente. Esto implica lo siguiente:

• La facturación automática a los clientes y el intento de pagos cada vez que comienza un nuevo ciclo de cobro.
• Cuando se produce un error de pago, Stripe lo reintenta usando la funcionalidad Smart Retries o tu calendario de reintentos personalizado. De esta manera, el pago se reintenta automáticamente cuando se rechaza una tarjeta, según la configuración del Dashboard. Si un error devuelve un código de rechazo permanente, los reintentos programados continúan, pero el pago se ejecuta solo si obtienes un nuevo método de pago.

También puedes enviar correos electrónicos de reclamación de pagos para los pagos vencidos, con el fin de aumentar las probabilidades de recuperación. Para los pagos que requieren la autenticación mediante 3D Secure, puedes configurar tus opciones de cobro de forma que se envíe un enlace alojado a los clientes para que puedan completar el flujo.

Estado del pago

El proceso de pago varía según los métodos de pago y la ubicación geográfica. Al principio, los pagos pueden fallar (por ejemplo, si el cliente introduce un número de tarjeta incorrecto o no tiene fondos suficientes), por lo que es posible que haya diferentes resultados de los pagos.

Un PaymentIntent sigue la vía del ciclo de vida de cada pago. Siempre que vence un pago por una suscripción, Stripe genera una factura y un PaymentIntent. El ID de PaymentIntent se adjunta a la factura y puede acceder a él desde los objetos Invoice y Subscription. El estado del PaymentIntent afecta al estado de la factura y de la suscripción. A continuación, se muestra cómo los diferentes resultados de un pago se corresponden con los diferentes estados:

En las siguientes secciones, se explican estos estados y las medidas que puedes tomar para cada uno.

Pago efectuado con éxito

Cuando tu pago se efectúa correctamente, el estado del PaymentIntent es succeeded, y la suscripción pasa a ser active. En el caso de los métodos de pago con períodos de procesamiento más largos, las suscripciones se activan de inmediato. En estos casos, el estado del PaymentIntent de una suscripción active puede ser processing hasta que se complete el pago.

Ahora que la suscripción está activa, brinda acceso a tu producto. Lee la guía para obtener más información sobre el ciclo de vida de las suscripciones y las mejores prácticas para el suministro.

{
  "id": "sub_1ELI8bClCIKljWvsvK36TXlC",
  "object": "subscription",
  "status": "active",
  ...
  "latest_invoice": {
    "id": "in_EmGqfJMYy3Nt9M",
    "status": "paid",
    "payments": {
      "data": [
        {
          "payment": {
            "type": "payment_intent",
            "payment_intent": {
              "status": "succeeded",
              ...
            }
          }
          ...
        }
      ],
    ...
  }
}

Requiere un método de pago

Si el pago falla debido a un error de la tarjeta, por ejemplo, porque es rechazada, el estado del PaymentIntent será requires_payment_method y la suscripción estará incomplete.

{
  "id": "sub_1ELI8bClCIKljWvsvK36TXlC",
  "object": "subscription",
  "status": "incomplete",
  ...
  "latest_invoice": {
    "id": "in_EmGqfJMYy3Nt9M",
    "status": "open",
    "payments": {
      "data": [
        {
          "payment": {
            "type": "payment_intent",
            "payment_intent": {
              "status": "requires_payment_method",
              ...
            }
          }
          ...
        }
      ],
      ...
    }
  }
}

Para resolver estos escenarios:

• Notifica al cliente.
• Recopila nueva información de pago y confirma el Payment Intent.
• Actualiza el default payment method en la suscripción.

Obtén información sobre cómo gestionar los errores de pago en las suscripciones.

Requiere intervención

Algunos métodos de pago requieren la autenticación del cliente con 3D Secure (3DS) para completar el proceso de pago. Si usas el API Payment Intents, el valor status del PaymentIntent es requires_action cuando un cliente tiene que autenticar un pago. Puedes obtener el PaymentIntent en el recurso Pago de facturas expandiendo latest_invoice.payments.data.payment.payment_intent o especificando el parámetro de la factura con Lista de pago de facturas. 3D Secure completa el proceso de autenticación. Un método de pago requerirá autenticación en función de tus reglas de Radar y del banco emisor de la tarjeta.

Las normativas europeas suelen exigir 3D Secure. Consulta la guía sobre la autenticación reforzada de clientes para determinar si la gestión de este estado es importante para tu empresa. Si ya tienes una integración de Stripe Billing y quieres agregar soporte para este flujo, también puedes revisar nuestra guía de migración a la SCA para Billing.

{
  "id": "sub_1ELI8bClCIKljWvsvK36TXlC",
  "object": "subscription",
  "status": "incomplete",
  ...
  "latest_invoice": {
    "id": "in_EmGqfJMYy3Nt9M",
    "status": "open",
    ...
    "payments": {
      "data": [
        {
          "payment": {
            "type": "payment_intent",
            "payment_intent": {
              "status": "requires_action",
              "client_secret": "pi_91_secret_W9",
              "next_action": {
                "type": "use_stripe_sdk",
                ...
              },
              ...
            }
          }
          ...
        }
      ],
    }
  }
}

Para gestionar estos escenarios:

• Supervisa la notificación de eventos invoice.payment_action_required con puntos de conexión de webhooks. Esto indica que se requiere autenticación.
• Notifica a tu cliente que debe realizar una autenticación.
• Recupera el secreto del cliente para el intento de pago y especifícalo en una llamada a stripe.ConfirmCardPayment. En este punto, se abre un cuadro de diálogo para que los clientes completen la autenticación, se intenta el pago, luego se cierra el cuadro de diálogo y tu aplicación recibe información de contexto.
• Controla el evento invoice.paid en el destino del evento para verificar que el pago se haya realizado correctamente. Los usuarios pueden abandonar la aplicación antes de que confirmCardPayment() termine. Verificar si el pago se efectuó en forma correcta te permitirá prestar el servicio como corresponde.

Estados de las suscripciones

Configuración y recuperación de suscripciones

Tu configuración de suscripciones determina cómo Stripe responderá cuando falle un pago o cuando venza una suscripción.

Smart Retries

Después de crear una suscripción, el fallo de pago es el evento más importante que puede ocurrir. Los fallos pueden ocurrir por muchas razones:

• Falta un método de pago del lado del cliente.
• Venció el método de pago.
• Se rechazó el pago.

Puedes configurar Stripe para reintentar pagos fallidos por un plazo de hasta dos meses en Gestionar pagos fallidos para suscripciones en el Dashboard. Smart Retries utiliza IA para elegir el momento óptimo para los reintentos durante el período configurado.

También puedes modificar el calendario de reintentos mediante reglas personalizadas. Puedes definir hasta tres intentos, cada uno con un determinado intervalo de días entre intento e intento.

Puedes usar el evento invoice.payment_failed para controlar los eventos de errores en el pago de suscripciones y reintentar las actualizaciones. Después de un intento de pago en una factura, el valor next_payment_attempt se establece según la configuración de suscripción vigente en tu Dashboard.

Si falla la recuperación, la suscripción se comportará conforme a tu configuración. Estas son las opciones:

Después del último intento de pago, no hacemos más intentos. El cambio de la configuración de suscripciones solo afectará los reintentos futuros.

Correos electrónicos

Stripe tiene la opción de enviar distintos correos electrónicos a los clientes usando las direcciones de correo electrónico asociadas a cada objeto Customer:

• Un recordatorio sobre una futura renovación al mismo tiempo que enviamos el evento invoice.upcoming para las suscripciones configuradas para cobrar el pago automáticamente.
• Una notificación de pago fallido para solicitarle al cliente que actualice su información de pago. Obtén información sobre cómo activar las notificaciones de pagos fallidos.
• Una notificación de tarjeta por vencer cuando la tarjeta default_source de un cliente esté a punto de vencer.

Puedes personalizar los logotipos y colores que tus clientes ven en los correos electrónicos y en nuestra página de pago de facturas alojadas cambiando la configuración de imagen de marca en el Dashboard.

Períodos de prueba

Las redes de tarjetas requieren que informes a tus clientes sobre sus pruebas. Stripe puede gestionar esta comunicación por ti. En el Dashboard, puedes configurar la URL de cancelación que se incluye tanto en los correos electrónicos de recordatorio como en el recibo de la primera factura después de que finalice una prueba. También puedes configurar la descripción del cargo en el extracto bancario para el primer cargo después de una prueba. Aprende más sobre estos requisitos y esta configuración en la página de pruebas.

Objetos de las suscripciones

Usa los siguientes recursos API para crear y gestionar suscripciones:

Veamos un ejemplo de cómo funcionan juntos los productos, las funcionalidades y los derechos. Imagina que quieres configurar un servicio de suscripción que ofrezca dos niveles: un producto estándar con funcionalidad básica y un producto avanzado que agregue funcionalidad extendida.

1. Creas dos funcionalidades: basic_features y extended_features.
2. Creas dos productos: standard_product y advanced_product.
3. Para el producto estándar, creas una ProductFeature que asocia basic_features con standard_product.
4. Para el producto avanzado, creas dos ProductFeatures: una que asocia basic_features con advanced_product y otra que asocia extended_features con advanced_product.

Un cliente, first_customer, se suscribe al producto estándar. Cuando creas la suscripción, Stripe crea automáticamente un derecho que asocia first_customer con basic_features.

Otro cliente, second_customer, se suscribe al producto avanzado. Al crear la suscripción, Stripe crea automáticamente dos derechos: uno que asocia second_customer con basic_features y otro que asocia second_customer con extended_features.

Puedes determinar qué funcionalidades aprovisionar para un cliente recuperando sus derechos activos o recibiendo notificaciones del evento Resumen de derechos activos. No tienes que recuperar sus suscripciones, productos y funcionalidades.

Eventos de suscripción

Los eventos se activan cada vez que se crea o cambia una suscripción. Algunos eventos se envían inmediatamente cuando se crea una suscripción, mientras que otros se repiten en intervalos de facturación regulares. Te recomendamos que escuches los eventos con puntos de conexión de webhook.

Asegúrate de que tu integración gestione los eventos de forma correcta. Por ejemplo, recomendamos enviarle un correo electrónico a un cliente si falla un pago o anular el acceso cuando se cancela una suscripción.

Consulta Eventos de suscripción para obtener una lista de los eventos más comunes relacionados con suscripciones y, cuando corresponda, las acciones sugeridas para gestionarlos.