- 21 Jun 2023
- OscuroLigero
Guía de integración para inicio rápido
- Actualizado en 21 Jun 2023
- OscuroLigero
Integrar comercio con Zenkipay
Una vez que has creado tu cuenta, deberás integrar el método de pago de Zenkipay en tu comercio, para realizarlo sigue los siguientes pasos:
- Ingresa al portal de comercios desde la página principal de Zenkipay y selecciona la opción de Integración con Plugins o API.
- Escanea tu sitio web y selecciona la mejor opción de integración
Personal Técnico
Durante este flujo puedes registrar al personal de tu equipo técnico para que realice las tareas específicas de tu integración. Más información.
Integración mediante plugins de E-commerce
Esta es la opción más sencilla para integrar un comercio, el proceso para integrar una plataforma de comercio electrónico es el siguiente:
- Instala el plugin de Zenkipay desde el Marketplace de tu plataforma de comercio electrónico.
- Accede a la configuración del plugin y pega la información de las credenciales que te fueron proporcionadas durante el registro.
- De manera opcional puedes solicitar credenciales para realizar pruebas.
Zenkipay ofrece plugins para: WooComerce, Magento y Prestashop.
Integración con API REST de Zenkipay
Si tu negocio no se encuentra sobre una plataforma de comercio electrónico o aún no contamos con un plugin para tu plataforma de comercio electrónico, deberas realizar la integración de tu portal de comercio electrónico mediante el API Rest de Zenkipay.
De alto nivel, estos son los pasos que deberás seguir para realizar esta integración:
- Agrega el botón de pago con Zenkipay en tu pagina de checkout.
- Si el cliente pagar con Zenkipay notifica a tu back-end que registre los datos de tu orden.
- Modifica el back-end para autenticar tu cliente de API Rest y obtener un Token JWT para llamar a los servicios del API de Zenkipay.
- Utiliza las credenciales proporcionadas durante el proceso de registro (client_id y client_secret).
- Una vez obtenido el token JWT debes utilizar el servicio para crear registrar la orden en Zenkipay.
- Utiliza los datos de respuesta de la creación de la orden para levantar la modal de pago.
- Ejecuta el evento de Javascript que abre la modal de pago.
- Para tu comodidad, hemos desarrollado plugins para algunas tecnologías de front end:
- Angular
- Vue.js
- React
- Si tu tecnología no se encuentra en el listado anterior, puedes realizar tu integración directamente con Javascript.
- Para tu comodidad, hemos desarrollado plugins para algunas tecnologías de front end:
- El cliente continua con el flujo de pago en la ventana modal de Zenkipay.
- Para consulta el estatus del pago del cliente. Puedes configurar un webhook para recibir la notificación de pago de la orden (debes exponer un servicio REST público para recibir estas notificaciones) o implementar en tu back-end la consulta de estatus de la ordenutilizando los servicios del API de Zenkipay.