Tarjetas
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 API Keys 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 tarjeta | Número de tarjeta | Token ID | CVC |
|---|---|---|---|
| Visa - Crédito | 4242424242424242 | tok_test_visa_4242 | 3 dígitos al azar |
| Visa - Crédito | 4012888888881881 | tok_test_visa_1881 | 3 dígitos al azar |
| Mastercard - Crédito | 5555555555554444 | tok_test_mastercard_4444 | 3 dígitos al azar |
| Mastercard - Crédito | 5105105105105100 | tok_test_mastercard_5100 | 3 dígitos al azar |
| American Express - Crédito | 378282246310005 | tok_test_amex_0005 | 3 o 4 dígitos al azar |
| American Express - Crédito | 371449635398431 | tok_test_amex_8431 | 3 o 4 dígitos al azar |
Tarjetas de débito
| Tipo de tarjeta | Número de tarjeta | Token ID | CVC |
|---|---|---|---|
| Visa - Débito | 4915669353237603 | tok_test_banorte_debit | 3 dígitos al azar |
| Mastercard - Débito | 5576041385402646 | tok_test_banco_azteca_debit | 3 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. Estos ejemplos corresponden a tarjetas de crédito.
| Error | Descripción | Acción a ejecutar | Cómo probar | Elementos 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_declined | La tarjeta se ha rechazado por un motivo desconocido. Nota:Podría presentarse este error también si la tarjeta usada se emitió fuera de México. | El cliente debe contactarse con su banco para obtener mayor información. | Pagar con la tarjeta en elementos de prueba. | 4000000000000002 |
| invalid_expiry_month | El 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_year | El 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_cvc | El 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 card | La 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_card | La 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_limit | La 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_behaviour | El 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_source | La 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_error | Se 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.
Updated over 1 year ago