Kit de Pruebas

Valida tu integración generando transacciones de prueba.

Usa la siguiente información para realizar todas las pruebas necesarias con respecto a los métodos de pago y algunos comportamientos relacionados, como por ejemplo, pagos declinados o tarjetas sin fondos.

❗️

Importante

Revisar que tus llaves pública y privada sean las correctas para el modo pruebas (sandbox).

Pruebas con tarjetas

Antes de empezar

Cuando empiezas a usar Conekta, debes de asegurarte de lo siguiente:

  • El número de tarjeta, fecha de expiración, código de seguridad (CVC) y el monto están ingresados correctamente en charge.new.
  • En el manejador de respuesta para charge.create, cualquier error debe ser considerado y manejado correctamente.
  • Información sensible de tarjeta (nombre, fecha de expiración y CVC) no deben de ser incluidas en la forma que está en tu servidor.

En el código del lado del servidor, puedes hacer las siguientes pruebas:

  • Todos los valores enviados por medio de la forma son válidos.
  • Todos los errores del API son manejados correctamente.
  • Todos los Webhooks de Conekta relevantes son manejados correctamente.

🚧

Si usas Checkout o Link de Pago

Si has decidido implementar el Checkout y/o Link de Pago, muchas de las validaciones previas hacia el cliente se hacen de manera automática, con lo que tienes una capa de validación adicional, y dependiendo del escenario, se disparan mensajes de error como: Número de tarjeta inválido, El teléfono no debe de tener más de 10 dígitos.

Tarjetas de prueba

En modo de pruebas, puedes usar los siguientes números de tarjetas de crédito o débito para simular una transacción exitosa. Ingresa información al azar para el nombre, CVC; para la vigencia de la tarjeta puedes agregar cualquier fecha futura:

Tarjetas de crédito

Todas las tarjetas son válidas para pagos a MSI (Meses Sin Intereses)

Tipo de tarjetaNúmero de tarjetaToken IDCVC
Visa - Crédito4242424242424242tok_test_visa_42423 dígitos al azar
Visa - Crédito4012888888881881tok_test_visa_18813 dígitos al azar
Mastercard - Crédito5555555555554444tok_test_mastercard_44443 dígitos al azar
Mastercard - Crédito5105105105105100tok_test_mastercard_51003 dígitos al azar
American Express - Crédito378282246310005tok_test_amex_00053 o 4 dígitos al azar
American Express - Crédito371449635398431tok_test_amex_84313 o 4 dígitos al azar

Tarjetas de débito

Tipo de tarjetaNúmero de tarjetaToken IDCVC
Visa - Débito4915669353237603tok_test_banorte_debit3 dígitos al azar
Mastercard - Débito5576041385402646tok_test_banco_azteca_debit3 dígitos al azar

🚧

Importante

Las tarjetas pueden funcionar muy bien en modo de pruebas. Al hacer pruebas en producción, se podrían rechazar las tarjetas de pruebas, ya que realmente no son tarjetas que corresponden a clientes reales.

Probar códigos de error

En la siguiente tabla encontrarás los principales errores que podrían ocurrir al procesar los pagos con tarjetas. En ella encontrarás las siguientes columnas:

  • Error. Es el nombre del error a replicar.
  • Descripción. Define cómo o por qué sucede el error.
  • Acción a ejecutar. Si el error ocurre, qué se tiene que hacer por parte del cliente o del negocio.
  • Cómo probar. Explica cómo se puede replicar el error para obtener el mensaje.
  • Elementos de prueba. Son los números de tarjeta o datos necesarios para replicar el error.
ErrorDescripciónAcción a ejecutarCómo probarElementos de prueba
insufficient_funds La tarjeta no tiene fondos suficientes.Se debe utilizar otro medio de pago o aguardar hasta tener saldo disponible.Pagar con una tarjeta sin fondos o que estos sean menores al monto de compra. Usar la tarjeta en elementos de prueba.4000000000000127
card_declinedLa tarjeta se ha rechazado por un motivo desconocido.El cliente debe contactarse con su banco para obtener mayor información.Pagar con la tarjeta en elementos de prueba.4000000000000002
incorrect_numberLa tarjeta no es válida.Se debe reintentar con una tarjeta válida.Usar un número que falle la prueba de Luhn como tarjeta. Ver ejemplo en elementos de prueba.4242424242424241
invalid_expiry_monthEl mes de la fecha de expiración de la tarjeta ingresada es incorrecta.Se debe reintentar con una fecha de expiración válida.Usar un mes inválido para la fecha de expiración. Ver ejemplo en elementos de prueba.Mes 14 en fecha de expiración.
invalid_expiry_yearEl año de la fecha de expiración de la tarjeta ingresa es incorrecta.Se debe reintentar con una fecha de expiración válida.Usar un año expirado, es decir, cualquier año anterior a 2023. Ver ejemplo en elementos de prueba.Año 99 en fecha de expiración.
invalid_cvcEl CVV ingresado no es válido o es incorrecto.Se tiene que tokenizar nuevamente la tarjeta con el CVC correcto. En caso de ser una tarjeta digital, verificar que se realice el pago dentro del periodo de validez antes de que expire.Usar un CVC de dos dígitos. Ver ejemplo en elementos de prueba.Usar 99 como CVV.
stolen cardLa tarjeta ingresada ha sido notificada como robada por el banco emisor.Por prevención de fraudes, se recomienda no comunicar este error al cliente y verificar que la compra se esté realizando por un usuario válido.Pagar con la tarjeta en elementos de prueba.4000000000009979
expired_cardLa tarjeta ha vencido y ya no es válida para pagar.Se debe reintentar con una tarjeta válida.Usar una fecha de expiración superior a la fecha actual. Ver ejemplo en elementos de prueba.Fecha de expiración: 03/40
card_over_limitLa tarjeta no cuenta límite de crédito suficiente para realizar el pago.Se debe reintentar con una tarjeta válida y con fondos suficientes.Pagar con la tarjeta en elementos de prueba.4000000000001724
suspicious_behaviourEl pago es declinado por Fortress, el motor de prevención de fraude de Conekta.Evitar dar detalles a los clientes, el motor de fraude rechazó el pago para cuidar tu negocio en línea.Pagar con la tarjeta en elementos de prueba.4000000000004954
blocked_payment_sourceLa tarjeta ha sido bloqueada para pagos dentro de Conekta. Posiblemente se hayan ingresado datos inválidos o la tarjeta no pueda ser procesada por el banco.Los reintentos de cobro con la misma tarjeta no podrán realizarse satisfactoriamente. Es necesario tokenizar una nueva tarjeta con datos correctos para intentar procesar el pago.Pagar con la tarjeta en elementos de prueba.4000000000009235
tok_test_msi_errorSe muestra porque el CVC no fue enviado en un intento de pago a meses sin intereses.Es necesario tokenizar nuevamente la tarjeta incluyendo el CVC y volver a realizar el intento de pago.Pagar con la tarjeta en elementos de prueba.4111111111111111

Importante:

  • Al utilizar el token tok_test_msi_error, regresará error: El tiempo de espera desde la captura de datos de la tarjeta expiró. Intenta de nuevo.
  • Si se tokeniza la tarjeta 4111111111111111 ó cualquier otra tarjeta válida y se crea un cargo dentro de 10 minutos, regresará una transacción exitosa, si pasa más de 10 minutos, regresará error El tiempo de espera desde la captura de datos de la tarjeta expiró. Intenta de nuevo.
  • Validación adicional en modo de pruebas (sandbox): Si no agregas información del cliente, será enviada como valor nulo.

Consulta más códigos de error de Direct API.