Pruebas

Para confirmar que tu integración funciona correctamente, simula transacciones sin transferir dinero usando valores especiales en modo de prueba o en entornos de prueba.

Las tarjetas de prueba funcionan como tarjetas de crédito falsas y te permiten simular varios casos:

• Pagos efectuados correctamente según la marca o el país de la tarjeta
• Card errors due to declines, fraud, or invalid data
• Disputas y reembolsos
• Autenticación mediante 3D Secure y PIN

Probar los pagos sin tarjeta funciona de la misma manera. Cada método de pago tiene sus propios valores especiales. Debido a los límites de velocidad, no te recomendamos que uses entornos de prueba para realizar pruebas de carga de tu integración. En su lugar, consulta pruebas de carga.

Cómo usar las tarjetas de prueba

Cada vez que trabajes con una tarjeta de prueba, usa las claves de prueba de la API en todas las llamadas a la API, tanto si ofreces un formulario de pago para probar de forma interactiva o para escribir código de prueba.

Pruebas interactivas

Cuando realices pruebas interactivas, usa un número de tarjeta, como 4242 4242 4242. Introduce el número de la tarjeta en el Dashboard o en cualquier forma 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 de forma interactiva con el número de tarjeta de prueba 4242 4242 4242 4242

Código de prueba

Cuando escribas el código de prueba, utiliza un PaymentMethod como pm_card_visa en lugar de un número de tarjeta. No recomendamos usar los números de tarjeta directamente en las llamadas a la API ni en el código del lado del servidor, ni siquiera en entornos de prueba. Si los usas, es posible que tu código no cumpla con la normativa PCI cuando pases a modo activo. De forma predeterminada, no se adjunta un PaymentMethod a un Customer.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=500 \
  -d currency=gbp \
  -d payment_method=pm_card_visa \
  -d "payment_method_types[]"=card

La mayoría de las integraciones ya no usan tokens, pero hacemos que los tokens de prueba como tok_visa estén disponibles si los necesitas.

Cuando esté todo listo para pasar la 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.

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, se muestran los números de tarjeta 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 las pruebas con ellas garantizan el manejo adecuado de las transacciones relacionadas con la atención sanitaria dentro de tu aplicación.

Pagos rechazados

Para poner a prueba la lógica de gestión de errores de tu integración simulando pagos que el emisor rechaza por varios 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 rechazo dados.

Prevención de fraude

Radar, el sistema de prevención de fraude de Stripe, puede bloquear pagos cuando estos presenten un nivel elevado de riesgo o fallen 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 de riesgo hacen que se bloquee un pago. Los pagos bloqueados dan lugar a errores de tarjeta con un código de error de fraude.

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: 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: utiliza un número de dos dígitos, por ejemplo 99.
• incorrect_number: utiliza un número de tarjeta que no cumpla la comprobación de Luhn, como 4242424242424241
  .

Disputas

Para simular una transacción disputada, usa las tarjetas de prueba de esta sección. Luego, para simular que has perdido la disputa o que se ha resuelto a tu favor, aporta la prueba correspondiente.

Pruebas

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 usando la API, pasa el valor de la tabla como uncategorized_text.
• Si respondes a la disputa en el Dashboard, introduce el valor de la tabla en el campo Información adicional. Luego, haz clic en Enviar prueba.

Reembolsos

En modo activo, los reembolsos son asíncronos. Un reembolso puede aparecer como correcto y después fallar, o aparecer como pending 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 reembolsos de tarjetas usando el Dashboard. En el modo activo, puedes cancelar el reembolso de una tarjeta en un período de tiempo breve, aunque no específico. Los entornos de prueba simulan ese período permitiéndote cancelar un reembolso de tarjeta en un plazo 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 mediante 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_acknowledged para omitir los pasos adicionales, ya que las pruebas de 3DS no son el objetivo de esas tarjetas.

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 pagos futuros o ya lo han sido.

Soporte 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.

Flujos de comprobación de 3D Secure para móviles

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.

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 tarjetas de prueba de abajo para simular este flujo.

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 Stripe Terminal de prueba 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:

1. 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.
2. Activa eventos con la CLI de Stripe o usando Stripe para Visual Studio Code.

Límites de velocidad

Si tus solicitudes en tus entornos de prueba comienzan a recibir errores HTTP 429, hazlas con menos frecuencia. Estos errores provienen de nuestro limitador de velocidad, que es más estricto en entornos de prueba que en modo activo.

No recomendamos realizar pruebas de carga de tu integración con la API de Stripe en entornos de pruebas. 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 de producción. Consulta pruebas de carga para buscar un enfoque alternativo.

Pagos sin tarjeta

Cada vez que uses un método de pago de prueba sin tarjeta, usa las claves de prueba de la API en todas las llamadas a la API, tanto si ofreces un formulario de pago que puedas probar de forma interactiva como si escribes código de prueba.

Los métodos de pago tienen diferentes procedimientos de prueba:

Link

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:

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 redireccionamientos (por ejemplo, iDEAL), utiliza un método de pago compatible que requiera redireccionamientos.

Para crear un PaymentIntent de prueba que sea procesado correctamente o que dé error:

1. Navega a la configuración de métodos de pago en el Dashboard y habilita un método de pago compatible haciendo clic en Activar en tu entorno de prueba.
2. Recopila los datos de pago.
3. Envía el pago a Stripe.
4. Autoriza o suspende el pago de prueba.

Asegúrate de que la página (correspondiente a return_url) de tu sitio web proporcione el estado del pago.