Tarjetas
Utiliza los datos proporcionados a continuación para llevar a cabo pruebas relacionadas con tarjetas y sus diversos comportamientos, como pagos rechazados o tarjetas sin saldo.
Importante
Revisa 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 utilizar 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 respuestas para charge.create, cualquier error debe ser considerado y manejado correctamente.
- Información sensible de tarjeta (como Nombre, Fecha de Expiración y CVC) no debe de ser incluida en la forma que está en tu servidor.
En el código del lado del servidor, puedes realizar 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 utilizas Checkout o Link de Pago
Si has decidido implementar nuestro Checkout y/o Link de Pago, muchas de las validaciones previas hacia el comprador son realizadas de forma automática por Conekta, por lo que tienes una capa de validación adicional y (dependiendo del escenario) se muestran mensajes de error como por ejemplo: 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 utilizar 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 y CVC; para la vigencia de la tarjeta puedes utilizar 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 |
| American Express - Crédito | 370781000000007 | tok_test_amex_0006 | 4 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
Ten en cuenta que los números de tarjetas proporcionados funcionan correctamente en modo de pruebas pero al utilizarlos en en producción podrían producir declinaciones ya que no son tarjetas 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 la siguiente información:
- 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é debe hacer el cliente o del comercio.
- 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 corresponden a tarjetas de crédito).
| Error | Descripción | Acción a ejecutar | Cómo probar | Elementos de prueba |
|---|---|---|---|---|
| insufficient_funds | La tarjeta ingresada no tiene fondos suficientes para completar la transacción. | Se debe utilizar otro método de pago o aguardar hasta tener saldo disponible. | Pagar con una tarjeta sin fondos o con fondos menores al monto total de compra. | 4000000000000127 |
| card_declined | La tarjeta se ha rechazado por motivos desconocidos. _Nota:_Este error también podría presentarse si la tarjeta ingresada fue emitida fuera de México. | El comprador debe contactarse con el banco emisor de la tarjeta 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 incorrecto (por ej.: mes 14 o mes 15). | Se debe reintentar con una fecha de expiración válida. | Utilizar un mes inválido para la fecha de expiración. | Mes 14 en fecha de expiración. |
| invalid_expiry_year | El año de la fecha de expiración de la tarjeta ingresada es incorrecto (por ej.: año 1999 o año 2145). | Se debe reintentar con una fecha de expiración válida. | Utilizar un año anterior al año corriente. | Año 99 en fecha de expiración. |
| invalid_cvc | El CVC 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 este expire. | Utilizar un CVC de dos dígitos. | Usar 99 como CVV. |
| stolen_card | La tarjeta ingresada fue reportada como perdida o robada. | Se recomienda no comunicar este error al cliente por prevención de fraudes y verificar que la compra esté siendo realizada por un usuario válido. | Pagar con la tarjeta en elementos de prueba. | 4000000000009979 |
| expired_card | La tarjeta ha vencido y no es válida para pagar. | Se debe reintentar con una tarjeta válida. | Utilizar una fecha de expiración superior a la fecha actual. | 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. | 4765889404833223 |
| suspicious_behaviour | El pago ha sido declinado por prevención de fraudes. | Evitar dar detalles adicionales a los clientes por prevención de fraudes. | Pagar con la tarjeta en elementos de prueba. | 4000000000004954 |
| blocked_payment_source | La tarjeta ha sido bloqueada para pagos a través de Conekta. Posiblemente se hayan ingresado datos inválidos o la tarjeta no pueda ser procesada por el banco. | Es necesario tokenizar una nueva tarjeta con datos correctos para intentar procesar el pago. | Pagar con la tarjeta en elementos de prueba. | 4000000000009235 |
| attempts_over_limit | La tarjeta ha superado el límite de intentos de cobro. | Se debe reintentar con una tarjeta válida que no supere el límite de intentos. | Pagar con la tarjeta en elementos de prueba. | 5201169598806528 |
| amount_over_limit | La tarjeta ha excedido el monto límite permitido. | Se debe reintentar con una tarjeta que no exceda el monto límite permitido. | Pagar con la tarjeta en elementos de prueba. | 5579234433467094 |
| invalid_expiration_date | La tarjeta ha vencido y ya no es válida para pagar. | Se debe intentar con una tarjeta valida. | Pagar con la tarjeta en elementos de prueba. | 4765881487764268 |
| call_issuer | La tarjeta no puede realizar pagos. | El comprador debe contactarse con el banco emisor de la tarjeta para obtener mayor información. | Pagar con la tarjeta en elementos de prueba. | 4134067352736334 |
| tok_test_msi_error | El CVC no fue enviado en un intento de pago a MSI (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, la API regresará el error: El tiempo de espera desde la captura de datos de la tarjeta expiró. Intenta de nuevo.
- Si tokenizas la tarjeta 4111111111111111 ó cualquier otra tarjeta válida y creas un cargo dentro de 10 minutos, se producirá una transacción exitosa. Si pasan más de 10 minutos, se producirá el siguiente 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 5 months ago