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.

Magento 2.3+

Guía de instalación para plugin de Magento en Conekta.

Primeros pasos

Para instalar el plugin de Conekta es necesario que cuentes con una tienda en Magento, una cuenta en Conekta e instales el plugin de Magento. Si aún no tienes alguna de estas, puedes:

Una vez que cuentes con ellas, necesitarás obtener tus API Keys y tenerlas a la mano.

Compatibilidad

  • Magento 2.2. o menor
  • PHP >= 7.0. ó <= 7.2.

📘

Importante

  • Antes de instalar el plugin de Conekta, recuerda tener instalado el plugin de Magento y tenerlo configurado al 100%.
  • Para descargar el plugin necesitarás tu “Key” que se genera al finalizar la instalación de Magento. En caso de no tener esa llave, puedes generar una nueva dentro de Magento. Para esto. ve a System->Manage Encryption Key.

Serás redirigido a la siguiente página.

En esta parte puedes auto generar la llave o generar una por tu cuenta. Al finalizar, da clic en el botón “Change Encryption Key” y de esa manera obtendrás tu Key para realizar descargas en el marketplace de Magento.

Limpiar cache

Ahora se requiere limpiar el Cache de Magento, para esto deberás ir a “System” -> “Cache Management”.

Te enviará a la siguiente página, donde solo es necesario hacer clic en el botón “Flush Magento Cache”.

Reindexación

Para más información consulta esta info: docs.magento.com

Ve a a “System” -> “Index Management”.

Aparecerá la siguiente página “Index Management”, en esta parte selecciona todos los “Indexer”, selecciona la opción “Update by Schedule” y da clic en el botón “Submit”.

Ahora sí, ve al Paso 1 para la instalación del plugin “Conekta".

Paso 1: Descarga el Plugin

Para descargar el plugin necesitaremos nuestra “Key” que se genera al finalizar la instalación de Magento, de no tener esa llave podremos generar una nueva desde Magento 2 como lo indica al inicio de esta guía.

Ya con nuestra llave lista nos iremos a la página de descarga aquí, seleccionamos el plugin para Magento 2 y hacemos todo el proceso de compra del plugin, al finalizar daremos clic en “Install”.

Nos mandará a la siguiente página, donde colocaremos nuestra “Key” generada por Magento 2 y daremos clic en “Ok”.

Nos genera las siguientes claves para poder agregar el plugin a Magento 2.

En nuestra página de Magento, nos iremos a “System” -> “Web Setup Wizard”.

Seleccionamos la opción de “Extension Manager”.

En esta parte nos pedirá las key’s que sacamos de marketplace de Magento, esto es para poder sincronizar nuestra tienda con el marketplace y así poder instalar el plugin de Conekta.

Cuando termine de validar las key’s nos mandara a la siguiente página, donde daremos clic en “Review and Install”.

Paso 2: Instala el Plugin

En la siguiente ventana nos apoyaremos de las flechas para desplazarnos hasta encontrar el plugin de Conekta.

Una vez lo encontremos le daremos clic en “install”.

Al dar clic en “install”, nos enviará a la siguiente ventana donde nos va a validar el plugin y si nuestra tienda cumple con los requisitos para poder instalar, si todo sale bien nos arrojará la siguiente página y daremos clic en “Next”.

Siguiendo el proceso de instalación daremos clic en “Create Backup”.

Damos clic en “Install” y esperamos a que se instale el plugin.

Damos clic en “Back to Setup Tool”.

Y en esta ventana tendremos que colocar la URL de nuestro admin de Magento 2 para poder seguir con la configuración de los métodos de pago.

Ahora toca configurar los métodos de pago de Conekta.

Paso 3: Configura el Plugin

Daremos clic en el menú en la opción de “Stores” -> “Configuration”.

En la siguiente ventana de Configuración daremos clic en “Sales” para poder desplegar las demás opciones que esta contiene.

Cuando se desplieguen las demás opciones dentro de “Sales”, seleccionaremos la opción de “Payment Methods” y ahí podremos observar los métodos de pago de Conekta.

Primero daremos clic en “Conekta Configuration”, esto para poder ingresar nuestras Keys que nos proporciona Conekta, tanto para hacer nuestras compras de pruebas como las de producción.

En esta parte también podrás colocar tu webhook, esto para poder recibir los eventos de API.

Nota

Para realizar compras de pruebas es necesarios colocar la opción de “Yes” en el campo de “Sandbox”, una vez termines de realizar las pruebas coloca la opción de “No”, de lo contrario no podrás recibir notificaciones en modo producción.

Activamos la opción de “Conekta Card”.

Podemos cambiar el título que tendrá nuestro método de pago en el checkout.

Podremos activar o desactivar lo meses sin intereses y seleccionar la cantidad ya sea a 3, 6, 9 y 12 meses.

Para la configuración de Oxxo Pay poder cambiar los días en los que se va a expirar el pago por default aparecen 30 días, por lo que se recomienda cambiar esa cantidad a una menor.

En esta parte se configura el método de pago SPEI, para empezar se tiene que activar la opción de “Enable” a “Yes”.

Podremos cambiar el titulo del método del pago y al igual que en OXXO podrás cambiar los días en los que expira un pago, en esta opción por default aparecen 180 días por lo que se recomiendo reducir esa cantidad de “Expiry (#days)”.

Al terminar, guarda las configuraciones realizadas y con esto ya tendrás listo los métodos de pagos y podrás empezar a realizar pruebas.

Puedes utilizar nuestras tarjetas de pruebas para realizar una compra de prueba y continuar con tu proceso de validación.

ESTE ES EL LINK PARA VER LAS TARJETAS DE PRUEBAS

La fecha de expiración puede ser cualquier fecha a futuro. El CVV pueden ser 3 números aleatorios.

Ejemplo:

tajerta: 4242 4242 4242 4242

fecha: 08/23

CVV: 777

📘

Dudas frecuentes

¿Qué mensualidades están disponibles?
Los meses sin intereses son de 3,6,9 y 12.

¿Cuál es el monto mínimo para usar menses sin intereses?
Para poder aplicar los meses sin intereses en una compra, los montos deben de ser mayores a 100 MXN al mes. por ejemplo, el monto mínimo para aplicar a 3 meses sin intereses, es de 300 MXN.

¿Hay algún monto máximo de pago en OXXO?
El máximo para realizar el pago en OXXO es de 10,000 MXN, de exceder esta cantidad, señalará un error y no procederá el pago.

🚧

Límites

  • El módulo no genera suscripciones (puedes generarlo con tu programador).
  • El módulo no genera customers (puedes generarlo con tu programador).

Updated 27 days ago

Magento 2.3+


Guía de instalación para plugin de Magento en Conekta.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.