Conekta Developer's Hub

Bienvenido al Conekta Developer's Hub. Aquí encontrarás la más robusta documentación del API Conekta y todos los tutoriales que te ayudarán a comenzar a recibir pagos de la manera más rápida, sencilla y segura.

KIT de Pruebas

Usa la siguiente información para realizar todas las pruebas necesarias con respecto a las tarjetas de pago y algunos comportamientos relacionados al uso de las tarjetas, como, pagos declinados o tarjeta sin fondos. Podrás así lanzar tu proyecto a producción usando Conekta en el menor tiempo posible..

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

  1. El número de tarjeta, fecha de expiración, el código de seguridad (CVC), y el monto están ingresados correctamente en charge.new.
  2. En el manejador de respuesta para charge.create, cualquier error debe ser considerado y manejado correctamente.
  3. Información sensible de tarjeta (nombre, fecha de expiración y CVC) no deben de ser incluidas en la forma que esta 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.

Antes de que comiences, revisa que tu llave pública y privada estén correctas.

NOTA: Es importante que si has decidido implementar el checkout Conekta (Embebido/Redireccionado) y/o link de pago Conekta, 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 invalido, El teléfono no debe de tener más de 10 dígitos.

¿Qué pruebas debo de hacer para integrar Conekta?

En modo de pruebas, puedes usar los siguientes números de tarjetas para simular una transacción exitosa (ingresa cualquier otra información relacionada a la tarjeta Esto es un nombre, un CVV al azar de 3 caracteres, la vigencia un mes y año al azar que no este en pretérito):

NOTA: Las tarjetas pueden funcionar muy bien en modo de pruebas, algunos sistemas como los plugins podrían rechazar las tarjetas de pruebas en PRODUCCIÓN ya que realmente no son tarjetas que corresponden a clientes

NÚMERO TOKEN ID TIPO DE TARJETA
4242424242424242 tok_test_visa_4242 Visa
4012888888881881 tok_test_visa_1881 Visa
5555555555554444 tok_test_mastercard_4444 MasterCard
5105105105105100 tok_test_mastercard_5100 MasterCard
378282246310005 tok_test_amex_0005 American Express
371449635398431 tok_test_amex_8431 American Express

Tarjeta de débito para pruebas. Al igual que con las tarjetas de crédito mencionadas en el párrafo anterior, deberás ingresa cualquier otra información relacionada a la tarjeta.

NÚMERO TIPO DE TARJETA
4915669353237603 VISA

Los siguientes números de tarjetas producen una respuesta específica y son útiles para probar diferentes escenarios:

NÚMERO TOKEN ID DESCRIPCIÓN
4000000000000002 tok_test_card_declined La tarjeta ingresada ha sido declinada. Por favor intenta con otro método de pago.
4000000000000127 tok_test_insufficient_funds Esta tarjeta no tiene suficientes fondos para completar la compra.
4111111111111111 tok_test_msi_error Simulaciones para Meses Sin Intereses.
  1. 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).
  2. 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).
  3. Validación adicional en modo de sandbox: Si no agregas información del cliente, será enviada como valor nulo.

¿Cómo puedo probar códigos de error específicos?

Estas son algunas sugerencias que proveemos:

ESCENARIO INSTRUCCIONES ELEMENTOS DE LA PRUEBA
card_declined Usa el número de la tarjeta Por ejemplo 4000000000000002
incorrect_number Usa un número que falla la prueba de Luhn Por ejemplo 4242424242424241
invalid_expiry_month Usa un mes inválido Por ejemplo 14
invalid_expiry_year Usa un año expirado Por ejemplo el año pasado
invalid_cvc Usa un cvc de dos dígitos Por ejemplo 99

La lista completa de códigos de error del API se puede encontrar en la documentación API.

¿Cómo puedo depurar Javascript?

Existen muchas herramientas para depurar errores en el lado del cliente. Recomendamos usar Web Inspector de Chrome.

¿Cómo puedo probar los Webhooks de Conekta?

Webhooks pueden ser configurado para el modo de prueba y producción dentro de tu panel/admin.