Requisitos para la integración

Para realizar la integración de los plugins de Zenkipay con las diferentes plataformas de eCommerce soportadas (WooCommerce, Magento, PrestaShop), es necesario seguir los siguientes pasos:

Es necesario tener una cuenta de comercio en Zenkipay para llevar a cabo la integración. En el siguiente enlace podrás encontrar a detalle los pasos a seguir para abrir tu cuenta: Registro.

Este paso es para recomendarte la mejor opción de integración con base a la tecnología que estas utilizando. En el siguiente enlace podrás encontrar más información al respecto: Escaneando tu sitio.

La seguridad es muy importante en Zenkipay, por ello le pedimos a los comercios que generen un par de llaves, una pública y una privada. Estas llaves permiten que la información de las transacciones esté cifrada y evitar que usuarios malintencionados puedan manipular los datos de las ordenes de compra, de esta forma garantizamos que la comunicación que hay entre la tienda y Zenkipay es confiable. En el siguiente enlace podrás encontrar el proceso que hay que seguir para generar este par de llaves: Preparativos para tu integración.

El webhook permitirá que Zenkipay confirme a la tienda que el pago por parte del cliente fue completado exitosamente y cambiará el estatus de las ordenes de compra que inicialmente se encuentran como Pendiente a Procesando (éste término dependerá de cada plataforma de eCommerce).

NOTA: El siguiente ejemplo es realizado con WooCommerce. Sin embargo, el proceso es el mismo para cualquier integración con una plataforma de eCommerce (WooCommerce, Magento, PrestaShop).

1. Para continuar con la configuración del webhook, es necesario tener el plugin instalado en la tienda. A continuación los enlaces con los pasos necesarios para la instalación en cada una de las plataformas de eCommerce soportadas:

• Instalación de plugin de WooCommerce
• Instalación de plugin de Magento
• Instalación de plugin de PrestaShop

2. Una vez generadas la llave pública y privada, el siguiente paso es configurar el webhook. Después de dar clic en el botón “Continuar”, se mostrará la siguiente ventana en donde debemos de dar clic en el botón “Add Endpoint” para ingresar la URL del endpoint de nuestra tienda y los eventos que deseamos recibir en ésta.

3. Ahora debes de ingresar la dirección URL del webhook de la tienda, la cual tiene la siguiente estructura https://mitienda.com/wc-api/wc_zenki_gateway, donde hay que reemplazar el dominio mitienda.com por el de la tuya. Es importante mencionar que la estructura de la URL del webhook es diferente para cada una de las plataformas:

• WooCommerce: https://mitienda.com/wc-api/wc_zenki_gateway
• Magento: https://mitienda.com/zenkipay/index/webhook
• PrestaShop: https://mitienda.com/module/zenkipay/notification

4. Es necesario marcar las casillas de los eventos (notificaciones) que queremos recibir en el webhook: order > order.paid. Una vez realizado este paso podremos crear el webhook y continuar dando clic en el botón “Review info”.

5. Finalmente tendrás toda la información necesaria para terminar de configurar el plugin de tu preferencia en tu tienda:

• Llave privada RSA
• Plugin key
• Webhook signing secret

Para continuar el proceso de configuración de tu comercio, haz un pago de pruebas. La plataforma esperará hasta que tu pago de pruebas se haya completado, el cuál puedes hacer desde tu tienda online una vez que hayas finalizado la configuración del plugin.

Puedes ver como realizar un pago aquí.