Pruebas
Simula pagos para probar tu integración.
Para probar tu integración, simula transacciones sin mover dinero utilizando valores especiales de prueba en un entorno de prueba. Puedes acceder a tus entornos de prueba utilizando el selector de cuentas situado en la parte superior derecha de la página o en el Dashboard.
Las tarjetas de prueba actúan como tarjetas de crédito falsas y te permiten simular las siguientes situaciones:
- Pagos exitosos con marca de la tarjeta o país
- Errores de tarjeta debido a pagos rechazados, fraude, o datos no válidos
- Disputas y reembolsos
- Autenticación con 3D Secure y PIN
Las pruebas de pagos sin tarjeta funcionan de forma similar. Los pagos sin tarjeta son métodos de pago que no son tarjetas de crédito o débito. Stripe admite varias opciones de pago sin tarjeta, como monederos digitales y transferencias bancarias. Cada método de pago tiene sus propios valores especiales.
No utilices entornos de prueba para pruebas de carga de tu integración porque podrías chocar con los límites de frecuencia. Para probar la carga de tu integración, consulta pruebas de carga.
Cómo usar las tarjetas de prueba
Siempre que trabajes con una tarjeta de prueba, utiliza claves API de prueba en todas las llamadas a la API. Esto es válido tanto si estás enviando un formulario de pago para realizar una prueba interactiva como si estás escribiendo código de prueba.
Error habitual
No utilice datos de la tarjeta reales. El Contrato de servicios de Stripe prohíbe realizar pruebas en modo activo utilizando datos de métodos de pago reales. Utiliza tus claves API de prueba y los números de tarjeta que aparecen a continuación.
Pruebas interactivas
Cuando realices la prueba de forma interactiva, utiliza un número de tarjeta, como 4242 4242 4242. Introduce el número de tarjeta en el Dashboard o en cualquier formulario de pago.
- Utiliza una fecha futura válida, como 12/34.
- Usa cualquier CVC de tres dígitos (cuatro dígitos si usas una tarjeta American Express).
- Utiliza el valor que desees para otros campos de formulario.

Prueba interactiva de un formulario con el número de tarjeta de prueba 4242 4242 4242 4242
Código de prueba
Cuando escribas código de prueba, utiliza un PaymentMethod
como pm_card_visa en lugar de un número de tarjeta. No recomendamos utilizar números de tarjeta directamente en las llamadas a la API o en el código del lado del servidor, ni siquiera en entornos de prueba. Si los utilizas, es posible que tu código no cumpla la normativa PCI cuando pase a modo en directo. De manera predeterminada, no se adjunta un PaymentMethod
a un Cliente.
La mayoría de las integraciones ya no utilizan tókenes, pero ponemos a tu disposición tókenes de prueba como tok_visa por si los necesitas.
Cuando esté todo listo para pasar tu integración al modo activo, reemplaza tus claves de API secretas y publicables de prueba por las claves activas. No puedes procesar pagos reales si tu integración sigue usando las claves de prueba de la API.
Tarjetas por marca
Para simular un pago realizado con éxito para una marca de tarjeta específica, utiliza las tarjetas de prueba de la siguiente lista.
Precaución
Las comisiones transfronterizas se establecen en función del país emisor de la tarjeta. Las tarjetas cuyo país emisor no es EE. UU. (como JCB y UnionPay) pueden 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 efectuados correctamente desde países específicos, utiliza tarjetas de prueba de las siguientes secciones.
Tarjetas de prueba HSA y FSA
A continuación encontrarás números de tarjetas de prueba para simular transacciones con Cuentas de ahorro para la salud (HSA) y Cuentas de gastos flexibles (FSA). Estas cuentas se utilizan habitualmente para gastos médicos, y realizar pruebas con ellas garantiza la correcta gestión de las transacciones relacionadas con la atención sanitaria dentro de tu aplicación.
Pagos rechazados
Para probar la lógica de gestión de errores de tu integración simulando pagos que el emisor rechaza por diversos 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.
Error habitual
Para simular un CVC incorrecto, debes utilizar cualquier número de tres dígitos. Si no proporcionas un CVC, Stripe no realizará la verificación del CVC, por lo que no se podrán producir errores en la verificación.
Prevención de fraude
El sistema de prevención de fraude de Stripe, Radar, puede bloquear pagos cuando tienen un nivel de riesgo alto o no superan las comprobaciones de verificación. Puedes utilizar 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 de riesgo hacen que bloquee un pago. Los pagos bloqueados dan lugar a errores de tarjeta con un código de error de fraude.
Error habitual
Para simular un error en la verificación del CVC, debes proporcionar un CVC utilizando cualquier número de tres dígitos. Para simular un error en la verificación del código postal, debes proporcionar cualquier código postal válido. Si no proporcionas esos valores, Radar no realizará las comprobaciones correspondientes, por lo que no se podrán producir errores en ellas.
Datos no válidos
Para probar errores derivados de información no válida, debes aportar datos que no sean válidos. No necesitas ninguna tarjeta de prueba especial; cualquier valor no válido funcionará. Por ejemplo:
- invalid_expiry_month: Utiliza un mes no válido, como 13.
- invalid_expiry_year: utiliza un año hasta 50 años en el pasado, como 95.
- invalid_cvc: utiliza un número de dos cifras, como 99.
- incorrect_number: utiliza un número de tarjeta que no supere la comprobación Luhn, como .
Disputas
Para simular una transacción disputada, utiliza las tarjetas de prueba de esta sección. A continuación, para simular que ganas o pierdes la disputa, proporciona pruebas para ganar o perder.
Prueba
Si quieres simular una disputa perdida o una resuelta a tu favor, responde con uno de los valores de prueba de la tabla que figura a continuación.
- Si respondes utilizando la API, pasa el valor de la tabla como uncategorized_text.
- Si respondes en el Dashboard o en los Componentes integrados de Connect, introduce el valor de la tabla en el campo Información adicional. A continuación, haz clic en Enviar pruebas.
Prueba | Descripción |
---|---|
winning_ | Cierra la disputa como resuelta a tu favor y abona en tu cuenta el importe del cargo y las comisiones correspondientes. |
losing_ | Cierra la disputa como perdida sin abono en tu cuenta. En el caso de las peticiones de información, cierra la petición de información sin escalarla. |
escalate_ | Escala la petición de información a un contracargo. Esto convierte la petición de información en una disputa completa y adeuda en tu cuenta el importe de la disputa y las comisiones relacionadas. |
Reembolsos
En modo activo, los reembolsos son asíncronos. Un reembolso puede aparecer como correcto y después fallar, o aparecer como pendiente
al principio y luego como correcto. Para simular reembolsos con estos comportamientos, usa las tarjetas de prueba de esta sección. (Con las demás tarjetas, los reembolsos se efectúan correctamente de inmediato y no cambian de estado).
Solo puedes cancelar un reembolso con tarjeta desde el Dashboard. En el modo activo, puedes cancelar un reembolso de tarjeta en un periodo de tiempo corto pero no específico. Los entornos de prueba simulan ese periodo al permitirte cancelar un reembolso de tarjeta en 30 minutos.
Saldo disponible
Para enviar los fondos de una transacción de prueba directamente a tu saldo disponible, utiliza las tarjetas de prueba de esta sección. Otras tarjetas de prueba envían fondos de un pago efectuado con éxito a tu saldo pendiente.
Autenticación 3D Secure
La autenticación mediante 3D Secure requiere un nivel de autenticación adicional en las transacciones con tarjeta de crédito. Las tarjetas de prueba de esta sección te permiten simular la activación de la autenticación en diferentes flujos de pago.
Solo las tarjetas de esta sección prueban de manera eficaz tu integración con 3D Secure simulando un comportamiento 3DS definido, como un flujo de comprobación o una tarjeta no aceptada. Otras tarjetas de prueba de Stripe pueden activar 3DS, pero devolvemos attempt_
para omitir los pasos adicionales, ya que las pruebas de 3DS no son el objetivo de esas tarjetas.
El Dashboard no es compatible
3D Secure no redireccionará los pagos creados directamente en el Dashboard de Stripe. En su lugar, usa el front-end de tu propia integración o haz una llamada a la API.
Autenticación y configuración
Para simular flujos de pago que incluyan autenticación, utiliza las tarjetas de prueba de esta sección. Algunas de estas tarjetas también pueden configurarse para futuros pagos, o ya se han configurado.
Compatibilidad y disponibilidad
Stripe solicita la autenticación cuando lo requiere la normativa o cuando se activa debido a tus reglas de Radar o a un código personalizado. Es posible que, aunque se solicite la autenticación, no pueda realizarse. Esto sucede, por ejemplo, si la tarjeta del cliente no está inscrita o si hay un error. Usa las tarjetas de prueba de esta sección para simular varias combinaciones de estos factores.
Nota
Todas las referencias de 3DS indican 3D Secure 2.
Flujo del desafío móvil 3D Secure
Hay disponibles varios flujos de comprobación para la autenticación de pagos móviles, en los que el cliente tiene que interactuar con las indicaciones de la interfaz de usuario. Utiliza las tarjetas de prueba de esta sección para activar un flujo de comprobación específico para la prueba. Estas tarjetas no son útiles para formularios de pagos basados en navegadores ni en llamadas a la API. En estos entornos, las tarjetas funcionan, pero no generan ningún comportamiento especial. Como no son útiles en las llamadas a la API, no ofrecemos valores PaymentMethod
ni Token
con los que hacer pruebas.
Flujo de comprobación | Número | Datos | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Fuera de banda | La autenticación mediante 3D Secure 2 debe completarse en todas las transacciones. Activa el flujo de comprobación con la interfaz de usuario fuera de banda. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Código de acceso de un solo uso | La autenticación mediante 3D Secure 2 debe completarse en todas las transacciones. Activa el flujo de comprobación con la interfaz de usuario de código de acceso de un solo uso. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Selección única | La autenticación mediante 3D Secure 2 debe completarse en todas las transacciones. Activa el flujo de comprobación con la interfaz de usuario de selección única. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Selección múltiple | La autenticación mediante 3D Secure 2 debe completarse en todas las transacciones. Activa el flujo de comprobación con la interfaz de usuario de selección múltiple. |
Prueba de captcha
Para evitar el fraude, Stripe podría mostrar una prueba de captcha al usuario en la página de pago. Usa las siguientes tarjetas de prueba para simular este flujo.
Descripción | Número | Datos |
---|---|---|
Prueba de captcha | El cargo se realiza si el usuario responde correctamente a la prueba de captcha. | |
Prueba de captcha | El cargo se realiza si el usuario responde correctamente a la prueba de captcha. |
Pagos con PIN
Utiliza las tarjetas de prueba en esta sección para simular pagos en persona exitosos cuando se utiliza un PIN. Hay muchas otras opciones para probar los pagos en persona, incluido un lector simulado y tarjetas de prueba físicas. Consulta Terminal de pruebas de Stripe para obtener más información.
Destinos de eventos
Para probar tu punto de conexión de webhook o destino de evento, elige una de estas dos opciones:
- Realiza acciones en un entorno de prueba que envíen eventos legítimos a tu destino de eventos. Por ejemplo, para activar el evento charge.succeeded, puedes usar una tarjeta de prueba que produzca un cargo correcto.
- Activa eventos con la CLI de Stripe o usando Stripe para Visual Studio Code.
Límites de frecuencia
Si las peticiones en tus entornos de prueba empiezan a recibir errores HTTP 429
, hazlas con menos frecuencia. Estos errores proceden de nuestro limitador de frecuencia, que es más estricto en los entornos de prueba que en el modo activo.
No recomendamos realizar pruebas de carga de tu integración utilizando la API de Stripe en entornos de prueba. Debido a que el limitador de carga es más estricto en entornos de prueba, podrías ver errores que no verías en el modo producción. Consulta pruebas de carga para buscar otras opciones.
Pagos sin tarjeta
Cada vez que utilices un método de pago sin tarjeta de prueba, utiliza las claves de prueba de la API en todas las llamadas a la API. Esto es válido tanto si estás enviando un formulario de pago para realizar una prueba interactiva como si estás escribiendo código de prueba.
Los distintos métodos de pago tienen diferentes procedimientos de prueba:
Link
Precaución
No almacenes datos de usuarios reales en las cuentas de Link del entorno de prueba. Úsalas como si estuvieran disponibles para el público, porque estas cuentas de prueba están asociadas con tu clave publicable.
Actualmente, Link solo funciona con tarjetas de crédito, tarjetas de débito y compras con cuentas bancarias cualificadas de EE. UU. Link requiere el registro del dominio.
Puedes crear cuentas en el entorno de prueba para Link usando cualquier dirección de correo electrónico válida. La siguiente tabla muestra los valores fijos de código de acceso de un solo uso que Stripe acepta para autenticar las cuentas en el entorno de prueba:
Valor | Resultado |
---|---|
Otros 6 dígitos que no aparezca a continuación | Completado correctamente |
000001 | Error, el código no es válido |
000002 | Error, el código ha caducado |
000003 | Error, se ha superado el número máximo de intentos |
Varias fuentes de financiación
A medida que Stripe añade compatibilidad para fuentes de financiamiento adicional, no necesitas actualizar la integración. Stripe las acepta automáticamente con el mismo tiempo de liquidación de transacciones y garantías que los pagos con tarjeta y cuenta bancaria.
Redireccionamientos
Para probar la lógica de gestión de redireccionamientos 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 una prueba PaymentIntent
que tenga éxito o dé error:
- Navega hasta los ajustes de los métodos de pago de en el Dashboard y activa uno compatible haciendo clic en Activar en tu entorno de pruebas.
- Recopilar 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 proporciona el estatus del pago.