Cómo integrar Izipay o Niubiz en WooCommerce: guía paso a paso

Respuesta corta: ninguno de los dos plugins está en el repositorio de WordPress. El de Izipay se descarga del portal de documentación de micuentaweb y el de Niubiz del portal de desarrolladores de Niubiz, y en los dos casos se sube como archivo ZIP. Lo que más veces rompe la integración no es la instalación: son las URL de notificación mal configuradas, que dejan los pedidos pagados en estado pendiente.

Aclaremos algo primero, porque se confunde mucho. Izipay y Niubiz son dos empresas distintas y competidoras. Niubiz es la antigua VisaNet Perú. Izipay opera sobre la plataforma micuentaweb, y por eso su plugin se llama por dentro woo-micuentaweb-payment. No se integran juntos ni comparten credenciales: eliges uno, o instalas los dos por separado como métodos de pago independientes.

¿Qué necesitas antes de empezar?

• Código de comercio activo con la pasarela que elijas. Es un trámite con el banco o con la pasarela, con documentos de la empresa, y es lo que más tarda. Inícialo el primer día del proyecto.
• Acceso de administrador a tu WordPress.
• Acceso al back office de comercio de tu pasarela, que es donde viven las claves.
• Dominio real con HTTPS. Niubiz lo exige explícitamente: su módulo no funciona en localhost.
• La moneda de WooCommerce igual a la de tu afiliación, con dos decimales. Si tu código de comercio es en soles y la tienda está en dólares, las transacciones fallan.

¿Dónde se descarga cada plugin?

Esta es la parte donde más guías se equivocan. Si buscas «Izipay» o «Niubiz» dentro de Plugins, Añadir nuevo, no vas a encontrar nada. Ninguno de los dos se publica en el repositorio de WordPress.

Izipay. Se descarga de el portal de plugins de micuentaweb. El archivo tiene la forma Mi_Cuenta_Web_WooCommerce_2.x-10.x_v1.18.x.zip y al instalarse aparece en tu lista como Izipay for WooCommerce. El propio nombre te dice el rango de WooCommerce que soporta, de la 2.x a la 10.x.

Niubiz. Se descarga de el portal de desarrolladores de Niubiz, en la fila de WooCommerce. El archivo es niubiz_woocommerce.zip.

En los dos casos la instalación es la misma: Plugins, Añadir nuevo, Subir plugin, eliges el ZIP, Instalar y Activar.

¿Cuál de los dos conviene?

Depende menos del precio que de tu instalación. Tres diferencias técnicas que importan de verdad:

• Almacenamiento de pedidos. El módulo de Izipay es compatible con el almacenamiento de alto rendimiento de WooCommerce. El manual de Niubiz, en cambio, pide dejar marcado el almacenamiento clásico en Ajustes, Avanzado, Características. Si tu tienda ya usa el nuevo, tenlo en cuenta antes de decidir.
• Versión de PHP. Niubiz declara soporte de PHP 7.4 a 8.1. Si tu hosting corre PHP 8.2 o superior, que hoy es lo normal, tienes un conflicto que resolver antes de empezar.
• Ritmo de actualización. La guía de Izipay va por la versión 1.17 del documento y su módulo por la 1.18. La guía de Niubiz es la versión 1.1, de abril de 2024, y su plugin figura como publicado en enero de 2024.

A cambio, Niubiz trae de fábrica algunas cosas muy peruanas: pago con Yape, pago por QR, canje de puntos, cuotas y PagoEfectivo integrado. Izipay cubre su propio abanico de medios y añade pago por token, wallet del comprador y suscripciones, aunque esas tres son opciones que se contratan aparte.

Cómo integrar Izipay en WooCommerce

1. Copia el ID de tienda y la clave de test

Entra a tu back office de comercio en secure.micuentaweb.pe/vads-merchant/, ve a Configuración, Tienda, pestaña Claves. Ahí están el ID de la tienda y la clave de test.

En WordPress ve a WooCommerce, Ajustes, pestaña Pagos, entra en Izipay y luego en Configuración general. Pega los dos valores y guarda.

2. Configura las URL de notificación

Este es el paso que decide si la integración funciona. Sin él, el cliente paga, el dinero sale de su tarjeta y el pedido se queda en pendiente para siempre.

En la misma pantalla del plugin, busca la sección de acceso al portal de pago y copia la URL de notificación. Tiene esta forma:

https://tudominio.com/?wc-api=WC_Gateway_Micuentaweb

Si usas el pago incrustado con la API REST, la URL es otra:

https://tudominio.com/?wc-api=WC_Gateway_Micuentaweb_Notify_Rest

Ahora vuelve al back office de Izipay, entra en Configuración, Reglas de notificaciones, y repite lo mismo en cada una de estas cinco reglas: notificación al final del pago, al abandonar, al modificar por lote, al modificar una transacción desde el back office y al crear una recurrencia.

En cada regla haz tres cosas: marca la casilla de repetición automática en caso de fallo, pega la URL tanto en el campo de modo prueba como en el de modo producción, y guarda. Si al terminar alguna regla aparece con una cruz roja, ábrela y pulsa el botón de activar la regla al pie de la pantalla.

Saltarse la casilla de repetición automática es el error silencioso más caro: sin ella, si tu servidor tarda un segundo de más en responder, esa venta no se confirma nunca.

3. Prueba con tarjetas de test

Haz un pedido en tu propia tienda como si fueras un cliente. En la pasarela, en modo prueba, se muestran los números de tarjeta de ejemplo y basta hacer clic en uno para que se rellenen todos los campos. Valida el pago y comprueba que el pedido cambia de estado en WooCommerce.

4. Pasa a producción

Vuelve a Configuración, Tienda, pestaña Claves. Si ves una tabla con varias líneas, Izipay te exige un pago de prueba por cada línea, con el número de tarjeta exacto que indica cada una, antes de dejarte continuar. Cuando las cruces rojas se vuelvan visto verde, pulsa Generar la clave de producción.

Copia esa clave, pégala en el campo correspondiente del plugin y cambia el parámetro Modo a producción. Guarda y ya estás cobrando de verdad.

Guarda esa clave de producción en un lugar seguro. El manual de Izipay avisa de algo que sorprende a mucha gente: al actualizar el módulo hay que desinstalar el anterior, y la clave de producción ya no vuelve a mostrarse en el back office. Si no la anotaste, tienes que regenerarla.

Cómo integrar Niubiz en WooCommerce

1. Prepara WooCommerce

Antes de tocar el plugin, dos comprobaciones. En WooCommerce, Ajustes, General, verifica que la moneda coincida con la de tu afiliación y que tenga dos decimales. Y en Ajustes, Avanzado, Características, deja marcado el almacenamiento clásico de pedidos, que es lo que pide el manual del módulo.

2. Configura el modo sandbox

Con el plugin activo, entra en WooCommerce, Ajustes, Pagos y administra el método Niubiz. Activa el módulo y el registro de logs, y marca las marcas de tarjeta que quieras aceptar.

Para las pruebas, Niubiz publica credenciales de sandbox en su manual oficial, con un merchant ID distinto según trabajes en soles o en dólares. Complétalas junto con la URL de tu logo, la de tus términos y condiciones, y el tiempo de espera.

Deja el registro de logs activado también en producción durante las primeras semanas. Cuando una venta falle, ese log es la única forma de saber si el problema fue de la tienda o de la pasarela.

3. Prueba con las tarjetas del manual

El manual trae dos tablas de tarjetas: una de ventas aprobadas y otra de ventas denegadas, con escenarios concretos como fondos insuficientes, contactar con el emisor o transacción rechazada por posible fraude.

Prueba las dos tablas, no solo la de aprobadas. Lo que de verdad hay que verificar es qué ve el cliente cuando el pago falla, y que el pedido no se quede a medias.

4. Pide el pase a producción

Aquí Niubiz funciona distinto a Izipay. No generas tú la clave: cuando terminas las pruebas, escribes al equipo de integraciones de Niubiz solicitando el pase a producción con el formato que indica su manual. Responden en un plazo de hasta 24 horas con fecha y enlace de una reunión, y en esa reunión te entregan las credenciales de producción.

Cuenta con esos días en tu calendario. Es el motivo más común de aperturas que se retrasan una semana justo al final.

¿Qué falla más y cómo se arregla?

• El pedido se queda en pendiente aunque el pago salió. Casi siempre son las URL de notificación. Revisa que estén en las cinco reglas, en los dos modos, y que ninguna regla esté desactivada.
• Funciona en pruebas y falla en producción. Suele ser que la URL de notificación del modo producción sigue apuntando al dominio de pruebas, o que quedó la clave de test.
• La pasarela rechaza el importe. Moneda distinta a la de la afiliación, o decimales mal configurados en WooCommerce.
• El método no aparece en el pago. Con Niubiz, revisa el almacenamiento de pedidos. Con cualquiera de los dos, revisa que tu tema o el bloque de pago del carrito sea compatible.
• Todo deja de funcionar tras actualizar. Actualizar el módulo de Izipay exige desinstalar el anterior. Si no anotaste la clave de producción antes, hay que regenerarla.

¿Y si prefieres no hacerlo tú?

Integrar una pasarela no es difícil, pero se paga caro equivocarse: un pedido que no confirma es una venta perdida y un cliente que ya pagó. Si prefieres que lo haga alguien que ya pasó por esto, mis planes de ecommerce van de S/ 550 a S/ 1,300 e incluyen la integración, las pruebas reales de compra y el pase a producción acompañado.

Cuéntame con qué pasarela estás afiliado y en qué versión de PHP corre tu hosting. Con esos dos datos se sabe en cinco minutos si el camino va a ser limpio o si hay que resolver algo antes.

Sigue leyendo

• Cómo crear una tienda online en Perú — Plataforma, envíos por distrito y facturación electrónica.
• ¿Cuánto cuesta una página web en Perú en 2026? — Rangos de precio por tipo de proyecto.
• Cómo contratar un desarrollador WordPress sin equivocarte — Las ocho preguntas para la entrevista.
• Servicio: Tiendas online y ecommerce — Con Izipay, Niubiz, Yape y envío por distrito.