Pruebas
Simula pagos para probar tu integración.
Para confirmar que tu integración funciona correctamente, simula transacciones sin mover dinero usando valores especiales en modo de prueba.
Test cards let you simulate several scenarios:
- Successful payments by card brand or country
- Errores de tarjeta debido a rechazos, fraude o datos no válidos
- Disputas y reembolsos
- La autenticación con 3D Secure y mediante PIN
Probar los pagos que no son con tarjeta funciona de manera similar. Cada método de pago tiene sus propios valores especiales. Debido a los límites de velocidad, no recomendamos usar el modo de prueba para probar la carga de tu integración. En su lugar, consulta nuestra documentación sobre pruebas 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.
Testing interactively
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 escribes el código 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 llamadas a la API o código del lado del servidor, incluso en modo de prueba. Si los usas, es posible que tu código no cumpla con la normativa PCI cuando pases al modo activo. De forma predeterminada, no se adjunta un PaymentMethod
a un Customer.
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 modo 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.
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.
Evidence
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 un reembolso de tarjeta desde el Dashboard. En el modo activo, puedes cancelar un reembolso de tarjeta en un período corto, pero no específico. El modo de prueba simula ese período permitiéndote cancelar un reembolso de 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. |
Captcha challenge
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 |
---|---|---|
Captcha challenge | The charge succeeds if the user correctly answers the captcha challenge. | |
Captcha challenge | The charge succeeds if the user correctly answers the captcha challenge. |
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 event destinations, choose one of these two options:
- Perform actions in test mode 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 modo 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 modo de prueba que en modo activo.
No recomendamos probar la carga de tu integración por medio de la API de Stripe en modo de prueba. Debido a que el limitador de carga es más estricto en modo de prueba, es posible que veas errores que no verías en producción. Consulta las pruebas 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
No almacenes datos de usuarios reales en cuentas de Link en modo de prueba. Trata estas cuentas de prueba como si fueran de acceso público, porque están asociadas a tu clave publicable.
Currently, Link only works with credit cards, debit cards, and qualified US bank account purchases. Link requires domain registration.
Puedes crear cuentas para Link en modo de prueba usando cualquier dirección de correo electrónico válida. La siguiente tabla muestra los valores fijos de los códigos de acceso de un solo uso que Stripe acepta para autenticar las cuentas en modo de prueba:
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.
Redirects
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 modo 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.