Cómo probar Stripe Billing

Obtén información sobre cómo probar tu integración con Billing.

Prueba de manera minuciosa tu integración antes de exponerla a los clientes o usarla para una actividad en modo activo. Utiliza los recursos de esta página y las pautas organizacionales (por ejemplo, manuales de operación, mediciones de calidad o listas de verificación de desarrollo) a fin de determinar si tu integración está lista para la producción.

Principios del modo activo

Antes de llevar tu integración a modo activo, revisa estas listas de verificación de Stripe:

Así es cómo se ve un flujo de integración típico.

Para integraciones de suscripciones e ingresos recurrentes, asegúrate de que, como mínimo, los siguientes componentes funcionen según lo previsto.

La tabla contiene las notificaciones de eventos para cada componente. Puedes configurar tu integración para escuchar estos eventos con el webhook. Lee esta guía para obtener más información sobre las notificaciones de eventos y las pruebas.

Componente	Descripción	Eventos
Creación de la cuenta del cliente	Asegúrate de que tu integración pueda recopilar correctamente la información que necesitas para crear un registro de cliente en Stripe. Tus clientes pueden ingresar esa información a través de Payment Links, Checkout, Elements, o un formulario de pago completamente personalizado creado con la API de Stripe. Independientemente del formulario que uses, asegúrate de ver el objeto Customer almacenado en Stripe. Puedes usar el Dashboard o la API para ver y administrar clientes.	`customer.created` `customer.subscription.created`
Invoicing	Las suscripciones generan facturas al final de cada ciclo de facturación. Dependiendo de tu método de cobro, puedes enviar una factura para cobrar el pago a plazo vencido o para confirmar un cargo automático. Asegúrate de que tu integración genere y envíe las facturas como esperas. Lee la guía para obtener más información sobre cómo crear y administrar facturas para suscripciones. Puedes usar relojes de prueba para simular ciclos de facturación, que incluyen la generación y el envío de facturas. Lee la guía de relojes de prueba para obtener información sobre casos de uso específicos para probar.	`invoice.created` `invoice.finalized` `invoice.finalization_failed` `invoice.paid` `invoice.payment_action_required` `invoice.payment_failed` `invoice.upcoming` `invoice.updated`
Gestión de suscripciones	Configura el portal de clientes para que tus clientes puedan administrar sus subscripciones e información de pago. Para probarlo, crea una suscripción en un entorno de prueba. Luego, inicia sesión en el portal como el usuario de prueba y actualiza la suscripción. Consulta el Dashboard o la API para ver si la suscripción refleja el cambio del cliente. Lee la guía de integración para obtener información sobre cómo configurar el portal de clientes.	`customer.subscription.deleted` `customer.subscription.paused` `customer.subscription.resumed` `customer.subscription.updated`
Pruebas	Ofrece a los clientes un período de prueba de tu servicio. Para probar que tu período de prueba esté configurado correctamente, puedes crear un clock de prueba. La suscripción debe generar una factura de valor cero para el período de prueba. Cómo probar los períodos de prueba con clocks de prueba. Para obtener más información sobre cómo funcionan los perídos de prueba, lee la guía de períodos de pruebas de la suscripción.	`customer.subscription.trial_will_end` `customer.subscription.updated`
Pagos fallidos	Los pagos de tus clientes pueden fallar por muchos motivos. Asegúrate de que la integración pueda gestionar las fallas, incluidos los reintentos de pago. Aprende a hacer pruebas con pagos fallidos.	`invoice.finalization_failed` `invoice.payment_failed` `invoice.payment_action_required`

Clocks de prueba

Los clocks de prueba te permiten simular objetos de Billing, como subscripciones, a lo largo del tiempo en el entorno de prueba. De esta manera, no tienes que esperar un año para ver cómo tu integración gestiona un pago que no se realizó correctamente para obtener una renovación anual. Los clocks de prueba no requieren programación: puedes crear simulaciones en el Dashboard. También puedes acceder a ellos a través de la API. Obtén más información sobre los clocks de prueba y sus casos de uso habituales.

Probar períodos de prueba de suscripciones

Primero, sigue estos pasos para empezar a usar los clocks de prueba:

Luego, puedes comenzar a probar los clocks de prueba. Supongamos que deseas que los clientes prueben tu producto sin costo con una prueba de siete días antes de que comiencen a pagar y deseas recopilar la información de pago con anticipación. Para simular esta situación con los clocks de prueba, sigue estos pasos:

Crea un nuevo clock de prueba y programa el frozen_time para el 1 de enero.
Agrega un cliente e incluye su método de pago. En este caso, usa una tarjeta de prueba .
Crea una suscripción y agrega un período de prueba gratuita de siete días:

Para agregar un período de prueba a una suscripción existente a través del Dashboard:

Busca la suscripción que deseas cambiar.

Haz click en Acciones.
Haz click en Actualizar suscripción.
Haz click en Agregar período de prueba e ingresa “siete” en el campo Días de prueba gratuita.
Haz click en Actualizar suscripción.

Después de crear una suscripción con un período de prueba gratuito, se crea una suscripción en estado trialing. Se genera una factura de $0.00 debido a la prueba gratuita.
Adelanta la fecha al 5 de enero para ver la notificación del evento customer.subscription.trial_will_end. Stripe envía la notificación tres días antes de que finalice la prueba. Puedes usar este evento de webhook para informar a tus clientes que el periodo de prueba finalizará pronto.
Adelanta la fecha hasta el 8 de enero para verificar que la suscripción ahora aparezca como paid. Se crea una factura por 50 SEK.
Adelanta la fecha de a un ciclo (por ejemplo, hasta el 8 de febrero para una suscripción mensual) para verificar que la suscripción se renueve correctamente.

Probar períodos de prueba sin clocks de prueba

Probar las notificaciones de webhooks relacionadas con suscripciones

Las integraciones de suscripciones dependen ampliamente de los webhooks. Configura un punto de conexión de webhook en tu servidor y especifica qué notificaciones de eventos deseas escuchar. Stripe emite notificaciones para eventos como una actualización o una cancelación de suscripción.

Para poner a prueba los webhooks, crea suscripciones de prueba reales o activa notificaciones de eventos con la CLI de Stripe o a través del Dashboard.

Después de configurar la CLI de Stripe y vincularla a tu cuenta de Stripe, puedes activar eventos del ciclo de vida de la suscripción para probar la integración de tu webhook. Si utilizas la CLI de Stripe para activar eventos, puedes ver las notificaciones de eventos en tu servidor a medida que llegan, lo que te permite verificar la integración de tu webhook directamente sin túneles de red ni firewalls.

Cuando utilizas la CLI de Stripe o el Dashboard para activar eventos, el evento que recibe tu webhook contiene datos falsos que no se corresponden con los datos de la suscripción. La forma más confiable de probar las notificaciones de webhooks consiste en crear suscripciones de prueba reales y gestionar los eventos correspondientes.

La siguiente tabla describe los eventos más comunes relacionados con las suscripciones y, cuando corresponda, sugiere qué medidas tomar para gestionar los eventos.



`customer.created`	Se envía cuando se crea correctamente un objeto Customer.
`customer.subscription.created`	Se envía cuando se crea la suscripción. El `status` de la suscripción puede ser `incomplete` si se exige la autenticación del cliente para completar el pago o si estableces `payment_behavior` en `default_incomplete`. Consulta el comportamiento del pago de la suscripción para obtener más información.
`customer.subscription.deleted`	Se envía cuando se termina la suscripción de un cliente.
`customer.subscription.paused`	Se envía cuando el `status` de una suscripción cambia a `paused`. Por ejemplo, se envía cuando una suscripción está configurada para pausarse cuando una prueba gratuita finaliza sin un método de pago. La facturación no se producirá hasta que se reanude la suscripción. No enviamos este evento si el cobro del pago está pausado porque las facturas se siguen creando durante ese período.
`customer.subscription.resumed`	Se envía cuando se reanuda una suscripción que anteriormente estaba en estado `paused`. Esto no se aplica cuando el cobro del pago no está en pausa.
`customer.subscription.trial_will_end`	Se envía tres días antes de que finalice el período de prueba. Si el periodo de prueba es menor de tres días, este evento se activa.
`customer.subscription.updated`	Se envía cuando se inicia o cambia una suscripción. Por ejemplo, este evento se activa cuando se renueva una suscripción, se agrega un cupón, se aplica un descuento, se agrega una partida de factura o se cambia de plan.
`entitlements.active_entitlement_summary.updated`	Se envía cuando se actualizan los derechos activos de un cliente. Cuando recibas este evento, puedes proporcionar o anular el acceso a las funciones de tu producto. Lee más sobre integración con derechos.
`invoice.created`	Se envía cuando se crea una factura para una suscripción renovada o una nueva. Si Stripe no recibe una respuesta correcta al evento `invoice.created`, la finalización de todas las facturas con cobro automático se retrasará hasta 72 horas. Obtén más información sobre cómo finalizar facturas. Para responder a la notificación, envía una solicitud a la API Finalize an invoice.
`invoice.finalized`	Se envía cuando una factura se finaliza correctamente y está lista para pagarse. Puedes enviar la factura al cliente. Consulta la finalización de la factura para obtener más información. Según tu configuración, cobramos automáticamente al método de pago predeterminado o intentamos el cobro. Consulta los correos electrónicos posteriores a la finalización para obtener más información.
`invoice.finalization_failed`	No se pudo finalizar la factura. Lee la guía y aprende a gestionar los fallos de finalización de facturas. Obtén más información sobre la finalización de facturas en la guía resumida sobre facturas. Inspecciona el last_finalization_error del objeto Invoice para determinar la causa del error. Si usas Stripe Tax, revisa el campo automatic_tax del objeto Invoice. Si `automatic_tax[status]=requires_location_inputs`, la factura no puede finalizarse y los pagos no se pueden cobrar. Notifica al cliente y recopila la ubicación del cliente requerida. Si `automatic_tax[status]=failed`, reintenta la solicitud más tarde.
`invoice.paid`	Se envía cuando la factura se paga correctamente. Puedes brindar acceso a tu producto cuando recibas este evento y el `status` de la suscripción sea `active`.
`invoice.payment_action_required`	Se envía cuando la factura requiere la autenticación del cliente. Aprende a gestionar la suscripción cuando la factura requiere intervención.
`invoice.payment_failed`	Falló el pago de una factura. El estado del PaymentIntent cambia a `requires_action`, mientras que el de la suscripción sigue siendo `incomplete` solo en la primera factura. Si falla un pago, puedes tomar varias medidas: Notifica al cliente. Obtén más información sobre cómo puedes configurar los parámetros de suscripción para habilitar Smart Retries y otras funcionalidades de recuperación de ingresos. Si estás usando PaymentIntents, recopila la nueva información de pago y confirma el PaymentIntent. Actualiza el método de pago predeterminado en la suscripción.
`invoice.upcoming`	Se envía unos días antes de la renovación de la suscripción. La cantidad de días se basa en el número establecido en Próximos eventos de renovación en el Dashboard. Para las suscripciones existentes, el cambio del número de días entrará en vigencia en el siguiente período de facturación. De ser necesario, aún puedes agregar más partidas de factura.
`invoice.updated`	Se envía tanto cuando un pago falla como cuando se efectúa correctamente. Si sucede esto último, el atributo `paid` se establece en `true` y el `status` será `paid`. Si el pago falla, `paid` se establece en `false` y el `status` permanecerá `open`. Los pagos fallidos también activan el evento `invoice.payment_failed`.
`payment_intent.created`	Se envía cuando se crea una PaymentIntent.
`payment_intent.succeeded`	Sent when a PaymentIntent has successfully completed payment.
`subscription_schedule.aborted`	Se envía cuando se cancela un calendario de suscripciones porque el retraso en el pago canceló la suscripción relacionada.
`subscription_schedule.canceled`	Se envía cuando se cancela un calendario de suscripciones, lo que también cancela las suscripciones asociadas activas.
`subscription_schedule.completed`	Se envía cuando se completan todas las fases de un calendario de suscripciones.
`subscription_schedule.created`	Se envía cuando se crea un nuevo calendario de suscripciones.
`subscription_schedule.expiring`	Se envía siete días antes de que expire el calendario de suscripción.
`subscription_schedule.released`	Se envía cuando se lanza un calendario de suscripción, o cuando se pausa y desvincula dicho calendario de la suscripción. La suscripción permanece.
`subscription_schedule.updated`	Se envía cuando se actualiza un calendario de suscripciones.

Probar pagos fallidos

Utiliza números de tarjetas de crédito de prueba específicos para activar pagos fallidos de suscripciones y facturas.

Algunas actualizaciones de suscripciones inducen a Stripe a facturar la suscripción e intentar el pago de inmediato (este intento sincrónico de pago puede darse en la factura inicial o en ciertas actualizaciones de facturas). Si este intento falla, el estado de la suscripción creada es incomplete.

Para probar los efectos de un pago fallido en una suscripción activa, adjunta la tarjeta 4000 0000 0000 0341 como método de pago predeterminado del cliente, pero usa un período de prueba para diferir el intento (basta un período de prueba que dure unos segundos o unos minutos). La suscripción se activa de inmediato, con un borrador de factura creada cuando finaliza el período de prueba. Se tarda aproximadamente una hora en abrir los cambios de estado de la factura. En ese momento, se intenta el cobro y el pago falla.

Usa los clocks de prueba para simular el avance del tiempo en el entorno de prueba, lo que hace que los recursos de Billing, como las suscripciones, cambien de estado y activen eventos de webhook. Esto te permite ver cómo tu integración maneja un pago que no se pudo realizar para una renovación trimestral o anual sin esperar un año.

Probar pagos que exigen 3D Secure

Usa la tarjeta 4000 0027 6000 3184 para simular la activación de 3D Secure para suscripciones y facturas.

Cuando se desencadena el flujo de autenticación con 3D Secure, puedes probar la autenticación de un intento de pago o un intento de autenticación fallido en el cuadro de diálogo de 3D Secure que se abre. Si el pago se autentica correctamente, se concreta el pago de la factura. Si la factura pertenece a una suscripción cuyo estado es incomplete, se activa la suscripción. Cuando el intento de pago falla, el intento de autenticación da error y la factura sigue open.

Prueba los pagos de facturas mediante transferencia bancaria

Para probar los pagos manuales de facturas mediante transferencia bancaria, haz lo siguiente:

En el entorno de prueba, crea una factura, establece el método de cobro en send_invoice y establece la matriz payment_settings[payment_method_types] en [customer_balance].
Busca la factura en el Dashboard y haz click en Enviar.
A tu cliente se le asignó un número de cuenta bancaria virtual único que puedes recuperar a través de la API de instrucciones financieras. Los datos bancarios virtuales también aparecen en la página de facturas alojadas y en el PDF.

Probar el método de pago predeterminado para facturas y suscripciones

Utiliza identificadores de tarjetas de prueba específicos para simular los métodos de pago predeterminados que se utilizan para suscripciones y facturas.

El método de pago proporcionado debe adjuntarse a la suscripción o al cliente de la factura configurándolo como default_payment method. Por ejemplo, si usas pm_card_visa para crear un método de pago Visa de prueba:

Llama al punto de conexión PaymentMethod Attach con pm_card_visa y al cliente previsto para la suscripción o factura
Con el ID del método de pago resultante, crea la suscripción o factura con este ID como default_payment_method.

Ahora, la suscripción o factura cargará este método de pago.

Obtén más información sobre cómo usar métodos de pago predeterminados para suscripciones y facturas.

Probar la verificación de la identificación fiscal del cliente

Utiliza estas identificaciones fiscales especiales para activar determinadas condiciones de verificación en entornos de prueba. El tipo de identificación fiscal debe corresponder al número de IVA de la UE o al número de empresa australiana (ABN).

Número	Tipo
`000000000`	Successful verification
`111111111`	Unsuccessful verification
`222222222`	La verificación queda pendiente por un tiempo indefinido

Pruebas automatizadas

Puedes configurar pruebas automatizadas para tu integración. Para optimizar las pruebas, haz lo siguiente:

Ten en cuenta la política de retención de datos para los datos relacionados con la suscripción en el entorno de prueba.
Evita reutilizar recursos como Cupones y Códigos de promoción en todas las pruebas.
Usa el servidor HTTP stripe-mock, que se basa en la API de Stripe y refleja fielmente el comportamiento de la API.