Pruebas
Simula pagos para probar tu integración.
Para confirmar que la integración funciona correctamente, simula transacciones sin transferir dinero usando valores especiales en el modo de prueba o en los entornos de prueba.
Las tarjetas de prueba funcionan como tarjetas de crédito falsas y te permiten simular varios escenarios:
- Pagos efectuados con éxito por marca de tarjeta o país
- Errores de tarjeta debido a rechazos, fraude o datos no válidos
- Disputas y reembolsos
- La autenticación con 3D Secure y mediante PIN
Las pruebas de los pagos sin tarjeta funcionan de manera similar. Cada método de pago tiene sus propios valores especiales. Debido a límites de frecuencia, no te recomendamos que uses entornos de prueba para probar la carga de tu integración. En su lugar, consulta la prueba de carga.
Cómo usar las tarjetas de prueba
Cada vez que trabajes con una tarjeta de prueba, usa las claves de API de prueba en todas las llamadas a la API, ya sea que estés brindando un formulario de pago para probar en forma interactiva o escribiendo códigos de prueba.
Errores habituales
No uses datos reales de la tarjeta. El contrato de servicios de Stripe prohíbe las pruebas en modo activo con datos reales del método de pago. Usa tus claves de API de prueba y los números de tarjeta que aparecen a continuación.
Pruebas interactivas
Cuando hagas pruebas interactivas, usa un número de tarjeta, como 4242 4242 4242 4242. Introduce este número en el Dashboard o en un formulario de pago.
- Usa una fecha futura válida, como 12/34
- Usa cualquier CVC de tres dígitos (cuatro dígitos si usas una tarjeta American Express)
- Usa cualquier valor para los demás campos del formulario.

Cómo probar un formulario en forma interactiva con el número de tarjeta de prueba 4242 4242 4242 4242
Código de prueba
Cuando escribas programación de prueba, usa un PaymentMethod
como pm_card_visa en lugar de un número de tarjeta. No recomendamos usar números de tarjeta directamente en las llamadas API ni en la programación del lado del servidor, ni siquiera en los entornos de prueba. Si los usas, es posible que la programación no cumpla con la normativa PCI cuando pases a modo activo. Un PaymentMethod
no se asocia a un cliente de forma predeterminada.
La mayoría de las integraciones ya no usan tokens, pero ponemos a tu disposición tokens de prueba como tok_visa por si los necesita.
Cuando esté todo listo para llevar la integración a modo activo, reemplaza tus claves de API secretas y publicables de prueba por las claves activas. No podrás procesar pagos reales si tu integración sigue usando claves de API de prueba.
Tarjetas por marca
Para simular un pago realizado con éxito para una marca de tarjeta específica, usa las tarjetas de prueba de la siguiente lista.
Precaución
Las comisiones transfronterizas se evalúan en función del país del emisor de la tarjeta. Las tarjetas en las que el país emisor no es EE. UU. (como JCB y UnionPay) podrían estar sujetas a una comisión transfronteriza, incluso en entornos de prueba.
La mayoría de las tarjetas Cartes Bancaires y eftpos son de marca compartida con Visa o Mastercard. Las tarjetas de prueba en la siguiente tabla simulan pagos exitosos con tarjetas de marca compartida.
Tarjetas por país
Para simular pagos exitosos de países específicos, usa tarjetas de prueba de las siguientes secciones.
HSA and FSA test cards 
Below are test card numbers for simulating transactions using Health Savings Accounts (HSA) and Flexible Spending Accounts (FSA). These accounts are commonly used for medical expenses, and testing with them ensures proper handling of healthcare-related transactions within your application.
Pagos rechazados
Para probar la lógica de gestión de errores de tu integración simulando pagos que el emisor rechaza por diferentes motivos, utiliza las tarjetas de prueba de esta sección. El uso de una de estas tarjetas da como resultado un error de tarjeta con el código de error y el código de pago rechazado brindados.
Errores habituales
Para simular un CVC incorrecto, debes proporcionar uno usando cualquier número de tres dígitos. Si no proporcionas un CVC, Stripe no realiza la comprobación del CVC, por lo que la verificación no puede fallar.
Prevención de fraude
Radar, el sistema de prevención de fraude de Stripe, puede bloquear los pagos que tienen un elevado nivel de riesgo o cuando fallan las comprobaciones de verificación. Puedes usar las tarjetas de esta sección para probar tu configuración de Radar. También puedes utilizarlas para probar cómo responde tu integración a los pagos bloqueados.
Cada tarjeta simula factores de riesgo específicos. Tu configuración de Radar determina qué factores ocasionan el bloqueo de un pago. Los pagos bloqueados dan como resultado errores de tarjeta con un código de error de fraude.
Errores habituales
Para simular un fallo en la comprobación del CVC, debes proporcionar un CVC. Puede ser cualquier número de tres dígitos. Para simular un fallo en la comprobación del código postal, debes proporcionar un código postal. Puede ser cualquier código postal válido. Si no ingresas estos valores, Radar no ejecutará las comprobaciones correspondientes, por lo que no podrás saber si fallan o no.
Datos no válidos
Para probar errores derivados de información no válida, debes proporcionar datos inválidos. No necesitas ninguna tarjeta de prueba especial: cualquier valor no válido funcionará. Por ejemplo:
- invalid_expiry_month: usa un mes no válido, como 13.
- invalid_expiry_year: usa un año hasta 50 años en el pasado, como 95.
- invalid_cvc: usa un número de dos dígitos, como 99.
- incorrect_number: usa un número de tarjeta que no pase la verificación de Luhn, como .
Disputas
Para simular una transacción disputada, usa las tarjetas de prueba de esta sección. Luego, para simular disputas resueltas a tu favor o en contra, proporciona las evidencias correspondientes.
Evidencias
Si quieres simular que ganas o pierdes la disputa, responde con uno de los valores de evidencias de la tabla que figura a continuación.
- Si respondes desde la API, especifica el valor de la tabla como uncategorized_text.
- Si respondes desde el Dashboard, introduce el valor de la tabla en el campo Información adicional. Luego, haz clic en Enviar evidencia.
Evidencia | Descripción |
---|---|
winning_ | La disputa está cerrada y marcada como resuelta a tu favor. El importe del cargo y las comisiones relacionadas se acreditan en tu cuenta. |
losing_ | La disputa está cerrada y marcada como perdida. No se acreditan fondos en tu cuenta. |
Rembolsos
En modo activo, los rembolsos son asincrónicos. El rembolso puede aparecer como efectuado con éxito y fallar después o aparecer pending
y concretarse más tarde. Para simular rembolsos con estos comportamientos, usa las tarjetas de prueba de esta sección. (Con las demás tarjetas, los rembolsos se efectúan correctamente de inmediato y no cambian de estado).
Solo puedes cancelar el reembolso de una tarjeta a través del Dashboard. En el modo activo, puedes cancelar el reembolso de una tarjeta en un período corto, pero no específico. Para simular ese período, los entornos de prueba te permiten cancelar el reembolso de una tarjeta en el transcurso de 30 minutos.
Saldo disponible
Para enviar los fondos desde una transacción de prueba directamente al saldo disponible, usa las tarjetas de prueba de esta sección. Las demás tarjetas de prueba envían los fondos de los pagos correctos a tu saldo pendiente.
Autenticación con 3D Secure
3D Secure requiere un paso más de autenticación en las transacciones con tarjeta de crédito. Con las tarjetas de prueba de esta sección puedes simular la autenticación en diferentes flujos de pago.
Solo las tarjetas de esta sección prueban con eficacia tu integración de 3D Secure simulando un comportamiento de 3D Secure definido, como un flujo de desafíos o una tarjeta que no se admite. Es posible que otras tarjetas de prueba de Stripe aún active 3D Secure, pero se devuelve el parámetro attempt_
para omitir los pasos adicionales, ya que las pruebas de 3D Secure no son el objetivo de esas tarjetas.
El Dashboard no es compatible
No habrá redireccionamiento a 3D Secure si los pagos se crean directamente en el Dashboard de Stripe. En su lugar, usa el front-end de tu propia integración o una llamada API.
Autenticación y configuración
Para simular flujos de pago que requieren autenticación, usa las tarjetas de prueba de esta sección. Algunas de estas tarjetas también se pueden configurar o ya están configuradas para pagos futuros.
Soporte y disponibilidad
Stripe solicita la autenticación cuando es exigida por la normativa o cuando se activa debido a las reglas de Radar o a tu código personalizado. Es posible que, aunque se solicite la autenticación, no pueda efectuarse. Esto sucede, por ejemplo, si la tarjeta del cliente no está inscrita o si se produce un error. Usa las tarjetas de prueba de esta sección para simular diferentes combinaciones de estos factores.
Nota
Todas las referencias 3D Secure indican 3D Secure 2.
Flujos de comprobación de 3D Secure para dispositivos móviles
Hay varios flujos de comprobación para la autenticación de pagos desde dispositivos móviles (en los que el cliente debe responder a indicaciones de la IU). Usa las tarjetas de prueba de esta sección para activar un determinado flujo de comprobación a efectos de la prueba. Estas tarjetas no son útiles para formularios de pagos basados en navegadores ni en llamadas de API. En esos entornos, las tarjetas funcionan, pero no activan ningún comportamiento especial. Debido a que no son útiles para las llamadas de API, no proporcionamos valores PaymentMethod
o Token
para hacer la prueba.
Flujo de comprobación | Número | Detalles | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Fuera de banda | Debe completarse la autenticación con 3D Secure 2 en todas las transacciones. Activa el flujo de comprobación con la IU de fuera de banda. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Código de acceso de un solo uso | Debe completarse la autenticación con 3D Secure 2 en todas las transacciones. Activa el flujo de comprobación con la IU de acceso de un solo uso. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Selección única | Debe completarse la autenticación con 3D Secure 2 en todas las transacciones. Activa el flujo de comprobación con la IU de selección única. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Selección múltiple | Debe completarse la autenticación con 3D Secure 2 en todas las transacciones. Activa el flujo de comprobación con la IU de selección múltiple. |
Desafío Captcha
Para evitar fraudes, Stripe podría presentarle un desafío de captcha al usuario en la página de pago. Usa las siguientes tarjetas de prueba para simular este flujo.
Descripción | Número | Detalles |
---|---|---|
Desafío Captcha | El cargo tiene éxito si el usuario responde correctamente al desafío captcha. | |
Desafío Captcha | El cargo tiene éxito si el usuario responde correctamente al desafío captcha. |
Pagos con PIN
Usa las tarjetas de prueba de esta sección para simular pagos con PIN en persona efectuados correctamente. Existen muchas otras opciones para probar pagos en persona, por ejemplo, con un lector simulado o tarjetas de prueba físicas. Consulta Probar Stripe Terminal para obtener más información.
Destinos de eventos
To test your webhook endpoint or event destination, choose one of these two options:
- Perform actions in a sandbox that send legitimate events to your event destination. For example, to trigger the charge.succeeded event, you can use a test card that produces a successful charge.
- Activa eventos con la CLI de Stripe o con Stripe para Visual Studio Code.
Límites de frecuencia
Si tus solicitudes en los entornos de prueba comienzan a dar errores HTTP 429
, haz solicitudes menos frecuentes. Estos errores provienen de nuestro limitador de frecuencia, que es más estricto en entornos de prueba que en el modo activo.
No recomendamos probar la carga de tu integración con la API de Stripe en entornos de prueba. Debido a que el limitador de carga es más estricto en entornos de prueba, es posible que veas errores que no verías en el modo activo. Consulta la prueba de carga para obtener un enfoque alternativo.
Pagos sin tarjeta
Cada vez que uses un método de pago de prueba sin tarjeta, usa las claves de API de prueba en todas las llamadas a la API, ya sea que estés brindando un formulario de pago que puedes probar en forma interactiva o escribiendo código de prueba.
Cada método de pago tiene un procedimiento de prueba diferente:
Link
Precaución
Don’t store real user data in sandbox Link accounts. Treat them as if they’re publicly available, because these test accounts are associated with your publishable key.
Currently, Link only works with credit cards, debit cards, and qualified US bank account purchases. Link requires domain registration.
You can create sandbox accounts for Link using any valid email address. The following table shows the fixed one-time passcode values that Stripe accepts for authenticating sandbox accounts:
Valor | Resultado |
---|---|
Otros seis dígitos diferentes de los mencionados a continuación | Operación correcta |
000001 | Error: código inválido |
000002 | Error: código vencido |
000003 | Error: cantidad máxima de intentos superada |
Múltiples fuentes de financiación
Como Stripe agrega soporte adicional para fuentes de financiamiento, no tienes que actualizar tu integración. Stripe las admite automáticamente con el mismo tiempo de liquidación de transacciones y garantías que los pagos con tarjeta y cuentas bancarias.
Redireccionamientos
Para probar la lógica de manejo de redireccionamiento de tu integración simulando un pago que utiliza un flujo de redireccionamiento (por ejemplo, iDEAL), utiliza un método de pago compatible que requiera redireccionamiento.
Para crear un PaymentIntent
de prueba que sea procesado correctamente o que dé error:
- Dirígete a la configuración de métodos de pago en el Dashboard y habilita un método de pago admitido haciendo clic en Activar en el entorno de prueba.
- Recopila los datos de pago.
- Envía el pago a Stripe.
- Autoriza o suspende el pago de prueba.
Asegúrate de que la página (correspondiente a return_
) de tu sitio web proporcione el estado del pago.