Zenki
Zenki Principal Habilitar modo claro/oscuro Habilitar modo claro/oscuro Habilitar modo claro/oscuro Regresar a la página principal
  1. Documentación Zenki
  2. /
  3. Zenkipay
  4. /
  5. Plugins
  6. /
  7. Magento

Magento

Zenkipay para Magento permite a los comercios aceptar pagos en su tienda con diferentes criptomonedas a través de múltiples billeteras.

Requerimientos

Es necesario que el servidor donde se encuentre alojada su tienda de Magento cuente con las siguientes características:

  • PHP 7.4 o mayor (depende de la versión de Magento)
  • MySQL 8.0
  • Apache 2.4 o Nginx con módulo mod_rewrite habilitado
  • Extensión de PHP cURL instalada
  • Soporte HTTPS
  • Magento 2.4.1 o mayor
  • Composer 2.2 o mayor

Instalación

  1. Desde la terminal de comandos ir a la raíz del proyecto y ejecutar los siguientes comandos para instalar la dependencia:
1
2
3
4

composer require zenki/zenkipay-magento
bin/magento module:enable Zenki_Zenkipay --clear-static-content
bin/magento setup:upgrade
bin/magento cache:clean

Configuración

  1. Una vez instalado y habilitado el módulo de Zenkipay en la tienda, desde el panel de administración hay que ingresar a Tiendas > Configuración > Ventas > Método de pago.

Step 1

Step 2

  1. La configuración del plugin consta de una serie de campos que hay que capturar para su correcto funcionamiento:
  • Habilitado: Habilitar Zenkipay como método de pago para Magento.
  • Modo de prueba: Servirá para indicar al plugin si se está trabajando con pruebas (modo Sandbox) o transacciones reales (Producción).
  • Llave de Sandbox Zenkipay: Es necesaria para realizar transacciones de prueba. En el siguiente enlace podrás encontrar los pasos a realizar para obtener esta llave: Requisitos para la integración de plugins.
  • Llave de producción Zenkipay: Esta llave sirve para comenzar a realizar transacciones reales. Durante el proceso de pruebas no es necesaria.
  • Firma secreta del webhook: Es necesaria para confirmar los pagos en la tienda. En el siguiente enlace podrás encontrar los pasos a realizar para obtener esta firma secreta: Requisitos para la integración de plugins.
  • Llave privada RSA: Esta llave privada es necesaria para firmar las peticiones de pago, verificar que la petición vienen de tu tienda y cerciorarnos de que nadie a manipulado los datos de compra. En el siguiente enlace podrás encontrar los pasos a realizar para obtener esta llave privada: Preparativos para tu integración.
  • Pago desde países aceptados: Permite indicar si el plugin estará disponible como método de pago para todos los países o solo algunos.
  • Pago desde países específicos: Permite seleccionar puntualmente los países sobre los cuales queremos tener disponible Zenkipay como método de pago.
  • Tipo de orden: Indicar el orden en que queremos que se muestre Zenkipay en el listado de métodos de pago que verá el cliente.

Step 3

NOTA: Si la llave de Zenkipay (sandbox o producción) es incorrecta, se mostrará un mensaje de error.

Webhook

El webhook del plugin permitirá que una vez realizado el pago por un cliente, Zenkipay confirme a la tienda de que el pago fue completado exitosamente y cambiará el estatus de la orden de compra que inicialmente se encuentra como “Pendiente” a “Procesando”.

La URL del webhook será configurada durante el proceso de registro de la cuenta de comercio de Zenkipay, el formato de la URL es el siguiente: https://mitienda.com/zenkipay/index/webhook.