Para confirmar que la integración funciona correctamente, simula transacciones sin transferir dinero usando valores especiales en el modo de prueba o en los entornos de prueba.
Las tarjetas de prueba funcionan como tarjetas de crédito falsas y te permiten simular varios escenarios:
Las pruebas de los pagos sin tarjeta funcionan de manera similar. Cada método de pago tiene sus propios valores especiales. Debido a límites de frecuencia, no te recomendamos que uses entornos de prueba para probar la carga de tu integración. En su lugar, consulta la prueba 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.
Pruebas interactivas
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 escribas programación 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 las llamadas API ni en la programación del lado del servidor, ni siquiera en los entornos de prueba. Si los usas, es posible que la programación no cumpla con la normativa PCI cuando pases a modo activo. Un PaymentMethod no se asocia a un cliente de forma predeterminada.
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 entornos de prueba.
Marca
PaymentMethod
Visa
pm_card_visa
Visa (débito)
pm_card_visa_debit
Mastercard
pm_card_mastercard
Mastercard (débito)
pm_card_mastercard_debit
Mastercard (prepaga)
pm_card_mastercard_prepaid
American Express
pm_card_amex
Discover
pm_card_discover
Diners Club
pm_card_diners
JCB
pm_card_jcb
UnionPay
pm_card_unionpay
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.
Marca
PaymentMethod
Cartes Bancaires/Visa
pm_card_visa_cartesBancaires
Cartes Bancaires/Mastercard
pm_card_mastercard_cartesBancaires
eftpos Australia/Visa
pm_card_visa_debit_eftposAuCoBranded
eftpos Australia/Mastercard
pm_card_mastercard_debit_eftposAuCoBranded
Tarjetas por país
Para simular pagos exitosos de países específicos, usa tarjetas de prueba de las siguientes secciones.
Para probar las suscripciones que requieren mandatos y notificaciones previas al débito, consulta Pagos recurrentes en India.
Australia (AU)
pm_card_au
Visa
China (CN)
pm_card_cn
Visa
Hong Kong (HK)
pm_card_hk
Visa
India (IN)
pm_card_in
Visa
Japón (JP)
pm_card_jp
Visa
Japón (JP)
pm_card_jcb
JCB
Malasia (MY)
pm_card_my
Visa
Nueva Zelanda (NZ)
pm_card_nz
Visa
Singapur (SG)
pm_card_sg
Visa
Taiwán (TW)
pm_card_tw
Visa
Tailandia (TH)
pm_card_th_credit
Visa (crédito)
Tailandia (TH)
pm_card_th_debit
Visa (débito)
HSA and FSA test cards
Below are test card numbers for simulating transactions using Health Savings Accounts (HSA) and Flexible Spending Accounts (FSA). These accounts are commonly used for medical expenses, and testing with them ensures proper handling of healthcare-related transactions within your application.
Brand/Type
PaymentMethod
Visa FSA
pm_card_debit_visaFsaProductCode
Visa HSA
pm_card_debit_visaHsaProductCode
Mastercard FSA
pm_card_mastercard_debit_mastercardFsaProductCode
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.
Descripción
Número
Código de error
Código de rechazo
Rechazo genérico
pm_card_visa_chargeDeclined
card_declined
generic_decline
Rechazo por fondos insuficientes
pm_card_visa_chargeDeclinedInsufficientFunds
card_declined
insufficient_funds
Rechazo por tarjeta extraviada
pm_card_visa_chargeDeclinedLostCard
card_declined
lost_card
Rechazo por tarjeta robada
pm_card_visa_chargeDeclinedStolenCard
card_declined
stolen_card
Rechazo por tarjeta vencida
pm_card_chargeDeclinedExpiredCard
expired_card
n/d
Rechazo por CVC incorrecto
pm_card_chargeDeclinedIncorrectCvc
incorrect_cvc
n/d
Rechazo por error de procesamiento
pm_card_chargeDeclinedProcessingError
processing_error
n/d
Pago rechazado porque se excedió el límite de velocidad
pm_card_visa_chargeDeclinedVelocityLimitExceeded
card_declined
card_velocity_exceeded
Las tarjetas de la tabla anterior no pueden asociarse a un objeto Customer. Para simular un pago rechazado con una tarjeta asociada correctamente, usa la siguiente tarjeta.
Descripción
PaymentMethod
Detalles
Rechazo después de la asociación
pm_card_chargeCustomerFail
La asociación de la tarjeta con el objeto Customer se efectúa correctamente, pero fallan los intentos de cobro al cliente.
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.
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:
Con la configuración de cuenta predeterminada, el cargo se efectúa correctamente, pero se disputa por fraudulento. Este tipo de disputas está protegido después de la autenticación mediante 3D Secure.
No recibido
pm_card_createDisputeProductNotReceived
Con la configuración de cuenta predeterminada, el cargo se efectúa correctamente, pero se disputa como producto no recibido. Este tipo de disputas no está protegido después de la autenticación mediante 3D Secure.
Solicitud de información
pm_card_createDisputeInquiry
Con la configuración de cuenta predeterminada, el cargo se efectúa correctamente, pero se disputa como una solicitud de información.
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_evidence
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_evidence
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).
Descripción
PaymentMethod
Detalles
Éxito asincrónico
pm_card_pendingRefund
El cargo se efectúa correctamente. Si emites un reembolso, el estado inicial será pending. Un tiempo después, el estado pasa a succeeded y envía un eventorefund.updated.
Error asincrónico
pm_card_refundFail
El cargo se efectúa correctamente. Si emites un reembolso, el estado inicial será succeeded. Un tiempo después, el estado pasa a failed y envía un eventorefund.failed.
Solo puedes cancelar el reembolso de una tarjeta a través del Dashboard. En el modo activo, puedes cancelar el reembolso de una tarjeta en un período corto, pero no específico. Para simular ese período, los entornos de prueba te permiten cancelar el reembolso de una 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.
Descripción
PaymentMethod
Detalles
Saltar saldo pendiente
pm_card_bypassPending
El cargo de EE. UU. se efectúa correctamente. Los fondos saltan el saldo pendiente y se agregan directamente al saldo disponible.
Saltar saldo pendiente
pm_card_bypassPendingInternational
El cargo internacional se efectúa correctamente. Los fondos saltan el saldo pendiente y se agregan directamente al saldo disponible.
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_acknowledged 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.
Descripción
PaymentMethod
Detalles
Autenticar excepto que esté configurada
pm_card_authenticationRequiredOnSetup
Esta tarjeta requiere autenticación en todos los pagos a menos que la configures para pagos futuros. Después de configurarla, la autenticación ya no será necesaria.
Autenticar siempre
pm_card_authenticationRequired
Esta tarjeta requiere autenticación en todas las transacciones, independientemente de cómo la hayas configurado.
Ya está configurada
pm_card_authenticationRequiredSetupForOffSession
Esta tarjeta ya está configurada para utilizarse fuera de la sesión. Requiere autenticación para pagos únicos y otros pagos durante la sesión. Sin embargo, todos los pagos fuera de la sesión se efectivizan como si la tarjeta se hubiera configurado antes.
Esta tarjeta requiere autenticación para pagos únicos. Se rechazan todos los pagos con un código de error insufficient_funds incluso después de autenticarse con éxito o haberse configurado antes.
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.
Uso de 3D Secure
Resultado
PaymentMethod
Detalles
Obligatoria
Aceptada
pm_card_threeDSecure2Required
Para que el pago se efectúe correctamente, debe completarse la autenticación con 3D Secure. Las reglas de Radar solicitan la autenticación con 3D Secure para esta tarjeta en forma predeterminada.
Obligatoria
Rechazada
pm_card_threeDSecureRequiredChargeDeclined
La autenticación con 3D Secure es obligatoria, pero los pagos se rechazan con un código de error card_declined después de la autenticación. Las reglas de Radar te solicitan la autenticación con 3D Secure para esta tarjeta en forma predeterminada.
Obligatoria
Error
pm_card_threeDSecureRequiredProcessingError
La autenticación con 3D Secure es obligatoria, pero la solicitud de búsqueda de 3D Secure falla y devuelve un error de procesamiento. Los pagos serán rechazados con un código de error card_declined. Las reglas de Radar solicitan la autenticación con 3D Secure para esta tarjeta en forma predeterminada.
Compatible
Aceptada
pm_card_threeDSecureOptional
La autenticación con 3D Secure se puede hacer de todos modos, pero no es obligatoria. Las reglas de Radar no te solicitan la autenticación con 3D Secure para esta tarjeta en forma predeterminada.
Compatible
Error
pm_card_threeDSecureOptionalProcessingError
La autenticación con 3D Secure se puede hacer de todos modos, pero no es obligatoria. Sin embargo, los intentos de autenticación con 3D Secure dan como resultado un error de procesamiento. Las reglas de Radar no solicitan la autenticación con 3D Secure para esta tarjeta en forma predeterminada.
Compatible
No inscrita
pm_card_visa
Esta tarjeta admite 3D Secure, pero no está inscrita en este método de autenticación. Incluso si las reglas de Radar solicitan 3D Secure, no se le pedirá al cliente que se autentique. De forma predeterminada, las reglas de Radar no solicitan la autenticación mediante 3D Secure para esta tarjeta.
No compatible
pm_card_amex_threeDSecureNotSupported
No se admite 3D Secure en esta tarjeta y no se puede invocar. El PaymentIntent o SetupIntent procede sin que se realice la autenticación.
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.
Desafío Captcha
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
Desafío Captcha
El cargo tiene éxito si el usuario responde correctamente al desafío captcha.
Desafío Captcha
El cargo tiene éxito si el usuario responde correctamente al desafío captcha.
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.
Descripción
Número
Detalles
PIN fuera de línea
offline_pin_cvm
Esta tarjeta simula un pago en el que se le solicita al titular de la tarjeta que ingrese un PIN fuera de línea y el titular lo hace. El cargo resultante tiene cardholder_verification_method establecido en offline_pin.
Reintento con PIN fuera de línea
offline_pin_sca_retry
Simula un flujo de reintentos activado por la SCA en el que falla el cargo inicial sin contacto del titular de la tarjeta y el lector solicita al usuario que inserte su tarjeta e introduzca su PIN fuera de línea. El cargo resultante tiene cardholder_verification_method establecido en offline_pin.
PIN en línea
online_pin_cvm
Esta tarjeta simula un pago en el que se le solicita al titular de la tarjeta que introduzca un PIN en línea y el titular lo hace. El cargo resultante tiene cardholder_verification_method establecido en online_pin.
Reintento con PIN en línea
online_pin_sca_retry
Simula un flujo de reintentos activado por la SCA en el que falla el cargo inicial sin contacto del titular de la tarjeta y el lector solicita al usuario que inserte su tarjeta e introduzca su PIN en línea. El cargo resultante tiene cardholder_verification_method establecido en online_pin.
Destinos de eventos
To test your webhook endpoint or event destination, choose one of these two options:
Si tus solicitudes en los entornos 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 entornos de prueba que en el modo activo.
No recomendamos probar la carga de tu integración con la API de Stripe en entornos de prueba. 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 activo. Consulta la prueba 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:
Obtén información sobre cómo probar escenarios con verificaciones instantáneas usando Financial Connections.
Send transaction emails in a sandbox
After you collect the bank account details and accept a mandate, send the mandate confirmation and microdeposit verification emails in a sandbox. To do this, provide an email in the payment_method_data.billing_details[email] field in the form of {any-prefix}+test_email@{any_domain} when you collect the payment method details.
Stripe provides several test account numbers and corresponding tokens you can use to make sure your integration for manually-entered bank accounts is ready for production.
Número de cuenta
Token
Número de enrutamiento
Comportamiento
000123456789
pm_usBankAccount_success
110000000
El pago se efectúa correctamente.
000111111113
pm_usBankAccount_accountClosed
110000000
Se produce un error en el pago porque la cuenta está cerrada.
000111111116
pm_usBankAccount_noAccount
110000000
Se produce un error en el pago porque no se encuentra ninguna cuenta.
000222222227
pm_usBankAccount_insufficientFunds
110000000
Se produce un error en el pago por fondos insuficientes.
000333333335
pm_usBankAccount_debitNotAuthorized
110000000
Se produce un error en el pago porque no se autorizan los débitos.
000444444440
pm_usBankAccount_invalidCurrency
110000000
Se produce un error en el pago por una divisa no válida.
000666666661
pm_usBankAccount_failMicrodeposits
110000000
Se produce un error en el envío de microdepósitos para el pago.
000555555559
pm_usBankAccount_dispute
110000000
El pago activa una disputa.
000000000009
pm_usBankAccount_processing
110000000
El pago permanece en el procesamiento de manera indefinida. Esto es útil para probar la cancelación PaymentIntent.
000777777771
pm_usBankAccount_weeklyLimitExceeded
110000000
Se produce un error en el pago debido a que el monto del pago hace que la cuenta exceda su límite de volumen de pago semanal.
Para completar las transacciones de prueba, debes verificar primero todas las cuentas de prueba que tengan pagos fallidos o efectivizados automáticamente. Para hacer esto, usa los importes de los microdepósitos de prueba o los códigos descriptivos que figuran a continuación.
Importes de microdepósitos de prueba y códigos descriptivos
Para imitar diferentes escenarios, usa estos importes de microdepósito o valores de código descriptivo 0.01.
Valores de microdepósitos
Valores de código descriptivo 0.01
Escenario
32 and 45
SM11AA
Simula la verificación de la cuenta.
10 y 11
SM33CC
Simula una situación en la que se excedió la cantidad de intentos de verificación permitidos.
40 y 41
SM44DD
Simula un tiempo de espera para microdepósitos.
Test settlement behavior
Test transactions settle instantly and are added to your available test balance. This behavior differs from livemode, where transactions can take multiple days to settle in your available balance.
Link
Precaución
Don’t store real user data in sandbox Link accounts. Treat them as if they’re publicly available, because these test accounts are associated with your publishable key.
Currently, Link only works with credit cards, debit cards, and qualified US bank account purchases. Link requires domain registration.
You can create sandbox accounts for Link using any valid email address. The following table shows the fixed one-time passcode values that Stripe accepts for authenticating sandbox accounts:
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.
Redireccionamientos
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: