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.

WooCommerce 5.2.2. o inferior

Guia de instalación para plugin Conekta en Wordpress-WooCommerce

Primeros pasos

Para instalar el plugin de Conekta es necesario que cuentes con una tienda en WooCommerce, con una cuenta en Conekta y hayas instalado el plugin de WooCommerce. 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

  • Woocommerce v.3.6.5.
  • Wordpress v.5.2.2.
  • PHP 7.2, 7.3.

📘

Importante

  • Antes de instalar el plugin de Conekta, recuerda tener instalado el plugin de WooCommerce y tenerlo configurado al 100%.
  • Contar con un sitio 'https' seguro

Paso 1: Instala el Plugin

Entraremos a nuestro administrador de nuestra tienda WordPress, en la parte del Menú, daremos clic en "Plugins" -> "Añadir nuevo", donde nos mandará a la siguiente página, en donde utilizaremos el buscador y escribimos "Conekta".

Una vez nos aparezca el plugin daremos clic en el botón de "Install Now".

Una vez instalado, daremos clic en el botón "Activar".

Paso 2: Configura el Plugin y los métodos de pago

Después de activar el plugin de Conekta, deberás personalizar los métodos de pago que ofrecerás.

Da clic en el Menú "WooCommerce" -> "Activar" -> "Pagos".

Verás en el cuadro inferior, dentro de la imagen siguiente, los métodos de pago de Conekta, los cuales se tienen que configurar y colocar en primer lugar entre los demás pagos presentes.

Para colocar los pagos en primer lugar de la tabla, les podemos dar clic a cada uno de ellos y arrastrar con el mouse a los primeros lugares o podemos utilizar las flechas de arriba-abajo que tienen a lado izquierdo de cada opción.

Al finalizar nos quedará de la siguiente manera.

Ahora pasemos a configurar cada uno de los pagos de Conekta.

Para el siguiente paso daremos clic en "Configuración" en cualquiera de los pagos a configurar.

Al dar clic en "Configuración" nos aparecerá la siguiente pantalla donde configuraremos cada una de las opciones de pago. En este caso configuraremos la opción de "Credit and Debit Card Payment".

En esta pantalla activaremos las opciones de "Enable Credit Card Payment".

Si vas a manejar meses sin intereses en tu tienda deberás activar la opción de "Enable Meses Sin Instereses"

La opción de "Turn on testing" se habilita solo en el momento que vayas a realizar compras de prueba, una vez que termines las compras de prueba recuerda deshabilitar esta opción.

En esta ventana también agregaremos nuestras llaves "Conekta API Test Private Key, Conekta API Test Public Key" y "Conekta API Live Private Key, Conekta API Live Public Key", para poder realizar los pagos, ya sean de pruebas o reales.

Al finalizar la configuración daremos clic en el botón "Guardar cambios".

Y en la ventana de pasarela de pagos deberá aparecer ya activado la opción de "Conekta Card".

Ahora toca configura la parte de "Oxxo Pay".

Debemos activar la opción dando clic en "Enable Conekta Oxxo Pay Payment", activar la casilla de "Turn on testing" en caso de realizar pruebas.

De igual manera colocamos las llaves que están en el admin de Conekta.

En esta ventana también podemos configurar los días de expiración para la referencia Oxxo, por default son 30 días, tu podrás colocar los días que quieras mayor a 0.

Al terminar da clic en "Guardar Cambios".

Ahora toca configurar el método de pago SPEI, recuerda colocar las llaves que te proporciona Conekta para que este pueda funcionar.

Al finalizar da clic en "Guardar Cambios".

Al terminar de configurar los métodos de pago deberán aparecer activados como lo muestra la siguiente imagen:

Paso 3: Configura el WebHook

Descripción: Un WebHook es un sistema utilizado por una aplicación para enviar información en tiempo real a otras aplicaciones.

Dentro de nuestro plugin vive un WebHook, el cual se encarga de recibir el evento de Order.paid desde nuestra API, este nos servirá para poder enviar un correo al cliente de que la orden se realizo con éxito y en caso de OXXO Pay enviará una referencia para poder realizar el pago en OXXO.

Para configurar este WebHook, lo tenemos que hacer desde nuestra página de Conekta.

Ingresamos con nuestra cuenta personal y nos vamos al apartado donde aparece el nombre de nuestra cuenta, en este caso el nombre es "Char_prueba" y daremos clic en "WebHooks".

Nos mandará a la siguiente página y daremos clic en el botón "Crear Webhook".

En este apartado ingresaremos el siguiente WebHook:
"https:// tusitio.com/wc-api/WC_Conekta_Cash_Gateway".

Recuerda reemplazar "tusitio.com" con el nombre de tu página web.

Una vez ingreses el nombre solo da clic en el botón "Crear".

Al dar clic en el botón, nuestro webhook deberá de quedar "Activo" como se muestra en la imagen siguiente.

Nota 2

Al terminar de realizar pruebas de pago, recuerda deshabilitar la casilla de "Turn on testing" en cada uno de los métodos de pago.

Limitar meses sin intereses

Limitar meses sin intereses
Tu desarrollador puede comentar las opciones no deseadas en los siguiente archivos, sin embargo, al modificar este plugin, Conekta no puede asegurar que funcione correctamente.

📘

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 plugin no genera suscripciones (puedes generarlo con tu programador)
  • El plugin no genera customers (puedes generarlo con tu programador)

Updated 22 days ago

WooCommerce 5.2.2. o inferior


Guia de instalación para plugin Conekta en Wordpress-WooCommerce

Suggested Edits are limited on API Reference Pages

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