Pruebas

Test your integration in a sandbox by simulating transactions with test values—these transactions don’t move funds.

You can access your sandboxes using the account picker in the Dashboard.

Test cards act as “fake” credit cards, and allow you to simulate the following scenarios:

• 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

You can also test non-card payments in a sandbox. Non-card payments are payment methods that aren’t credit or debit cards. Stripe supports various non-card payment options, such as digital wallets and bank transfers. Each payment method has its own special values.

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

When you work with a test card, use test API keys in all API calls. This is true whether you’re serving a payment form to test interactively or writing test code.

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ó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

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.

Simulate a payment by card brand

Para simular un pago exitoso para una marca de tarjeta específica, usa las tarjetas de prueba de la siguiente lista.

Las comisiones transfronterizas se determinan en función del país del emisor de la tarjeta. Las tarjetas emitidas fuera de los 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.

Simulate a payment by country

Para simular pagos exitosos de países específicos, usa tarjetas de prueba de las siguientes secciones.

Simulate an HSA or FSA card payment

Below are test card numbers for simulating transactions using a health savings account (HSA) and a flexible spending account (FSA). These accounts are commonly used for medical expenses, and testing with them ensures proper handling of healthcare-related transactions within your application.

Simulate a declined payment

To test your integration’s error-handling logic by simulating payments that the issuer declines for various reasons, use test cards from this section. These cards return a card error with the listed error code and decline code.

Provide a CVC when you test CVC behavior. Stripe skips the CVC check if you omit it, so the check can’t fail. To simulate an incorrect CVC, use the “Incorrect CVC decline” test card listed in the following table and provide any three-digit CVC.

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.

To trigger a failed CVC check, include a CVC (any three-digit number). To trigger a failed postal code check, include any valid postal code. If you omit these fields, Radar skips those checks, so they can’t fail.

Trigger an error with invalid data

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: Use a card number that fails the Luhn check, such as 4242424242424241.

Simulate a dispute

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.

Simulate an asynchronous refund

In live mode, refunds are asynchronous: a refund can appear to succeed and later fail, or can appear as pending at first and later succeed. To simulate refunds with those behaviors, use the test cards in this section. With all other test cards, refunds succeed immediately and don’t change status after that.

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.

Send funds to your available balance

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.

Test 3D Secure authentication

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.

Todas las referencias a 3DS 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 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.

Simulate a captcha challenge

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.

Simulate an in-person payment with a 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.

Test a webhook or event destination

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.

Test a non-card payment method

When you use a test non-card payment method, use test API keys in all API calls. This is true whether you’re serving a payment form you can test interactively or writing test code.

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

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

Test a redirect-based flow

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. Go to the payment methods settings in the Dashboard and enable a supported payment method by clicking Turn on in your testing environment.
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.