Pruebas

Para probar tu integración, simula transacciones sin mover dinero con valores de prueba especiales en un entorno de prueba. Puedes acceder a tus entornos de prueba con el selector de cuentas en la parte superior derecha de la página o desde el Dashboard.

Las tarjetas de prueba actúan como tarjetas de crédito falsas y te permiten simular los siguientes escenarios:

• Pagos exitosos por marca de tarjeta o país
• Errores de tarjeta por pagos rechazados, fraude o datos no válidos
• Disputas y rembolsos
• Autenticación con 3D Secure y PIN

Las pruebas de pagos sin tarjeta funcionan de manera similar. Se consideran pagos sin tarjeta los métodos que no emplean tarjetas de crédito ni de débito. Stripe admite varias opciones de pago sin tarjeta, como carteras digitales y transferencias bancarias. Cada método de pago tiene sus propios valores especiales.

No uses entornos de prueba para probar la carga de tu integración porque podrías alcanzar los límites de frecuencia. Para probar la carga de tu integración, consulta la sección 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 API, ya sea que estés presentando un formulario de pago para pruebas interactivas o escribiendo códigos de prueba.

Pruebas interactivas

Cuando hagas pruebas interactivas, usa un número de tarjeta, por ejemplo, 4242 4242 4242 4242. Ingresa 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 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, 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 de API ni en el código del lado del servidor, ni siquiera en modo de prueba. Si lo haces, es posible que tu código no cumpla con la normativa del PCI cuando pases a modo activo. De forma predeterminada, no se adjunta un PaymentMethod a un Cliente.

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 ponemos a tu disposición tokens de prueba como tok_visa por si los necesitas.

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 exitoso para una marca de tarjeta específica, usa 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 exitosos de países específicos, usa tarjetas de prueba de las siguientes secciones.

Tarjetas de prueba de HSA y FSA

A continuación, se muestran los 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 suelen utilizar para gastos médicos, y su uso en pruebas garantiza el manejo correcto de transacciones relacionadas con la atención médica 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 distintos motivos, utiliza las tarjetas de prueba de esta sección. El uso de una de estas tarjetas genera un error de tarjeta con el código de error y el código de rechazo correspondientes.

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 generan 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, ingresa datos no 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 (p. ej., 13).
• invalid_expiry_year: usa un año de hasta 50 años atrás, por ejemplo, 95.
• invalid_cvc: utiliza un número de dos dígitos (p. ej., 99).
• incorrect_number: usa un número de tarjeta que no pase la verificación de Luhn, por ejemplo, 4242424242424241
  .

Disputas

Para simular una transacción en disputa, 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 a través de la API, especifica 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 evidencia.

Reembolsos

En modo activo, los rembolsos son asincrónicos. El rembolso puede aparecer como efectuado correctamente y fallar después, o aparecer como pending al principio y completarse después. Para simular rembolsos con esos 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 a tarjeta desde el Dashboard. En modo activo, puedes hacerlo dentro de un período corto, pero no específico. Los entornos de prueba simulan ese período y te permiten cancelar un reembolso a tarjeta dentro de los 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 de manera efectiva tu integración en 3D Secure cuando simulan comportamientos específicos de 3D Secure, como un flujo de comprobación o una tarjeta no admitida. Otras tarjetas de prueba de Stripe podrían activar 3D Secure, pero devolvemos attempt_acknowledged para omitir los pasos adicionales, ya que la prueba de 3D Secure no es el objetivo en esos casos.

Autenticación y configuración

Para simular flujos de pago que incluyan autenticación, usa las tarjetas de prueba de esta sección. Algunas de estas tarjetas también se pueden configurar para pagos futuros o ya se encuentran configuradas.

Soporte y disponibilidad

Stripe solicita autenticación cuando la normativa lo exige o cuando la activan tus reglas de Radar o tu código personalizado. Aunque se solicite autenticación, no siempre puede ejecutarse, por ejemplo, la tarjeta del cliente podría no estar registrada o podría producirse un error. Usa las tarjetas de prueba de esta sección para simular distintas combinaciones de estos factores.

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

Desafío Captcha

Para evitar fraudes, Stripe puede mostrar un desafío captcha al usuario en la página de pago. Usa las tarjetas de prueba a continuación para simular este flujo.

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 la sección Probar Stripe Terminal para obtener más información.

Destinos de eventos

Para probar tu punto de conexión de webhooks o destino de evento, elige una de estas dos opciones:

1. Ejecuta acciones en un entorno de prueba que envíen eventos legítimos al destino de tu evento. Por ejemplo, para activar el evento charge.succeeded, puedes usar una tarjeta de prueba que dé como resultado un cargo efectuado con éxito.
2. 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 recibir errores HTTP 429, envíalas con menos frecuencia. Estos errores se originan en nuestro limitador de frecuencia, que es más estricto en entornos de prueba que en modo activo.

No recomendamos hacer pruebas de carga de tu integración usando la API de Stripe en entornos de prueba. Como el limitador de carga es más estricto en los entornos de prueba, es posible que veas errores que no aparecerían en producción. Consulta la sección de pruebas de carga para ver otras alternativas.

Pagos sin tarjeta

Cada vez que uses un método de pago de prueba que no sea con tarjeta, utiliza claves de API de prueba en todas las llamadas de API. Esto aplica tanto si estás implementando un formulario de pago para pruebas interactivas o desarrollando un código de prueba.

Cada método de pago tiene un procedimiento de prueba diferente:

Link

En este momento, Link solo funciona con tarjetas de crédito, tarjetas de débito y compras que califican de cuentas bancarias de EE. UU. Link exige el registro del dominio.

Puedes crear cuentas en entornos de prueba para Link usando cualquier dirección de correo electrónico válida. En la siguiente tabla se muestran los valores fijos de código de acceso de único que Stripe acepta para autenticar las cuentas de entornos de prueba:

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 gestión de redireccionamientos de tu integración simulando un pago que utiliza un flujo de redireccionamiento (p. ej., iDEAL), usa un método de pago compatible que requiera redireccionamientos.

Sigue estos pasos para crear un PaymentIntent de prueba que se procese correctamente o que dé error:

1. Ve a la configuración de los métodos de pago en el Dashboard y haz clic en Activar en tu entorno de prueba para habilitar un método de pago admitido.
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.