Cómo integrar Niubiz con WooCommerce en Perú

Niubiz es, junto con Izipay, la pasarela de tarjetas más fuerte del mercado peruano. Antes se llamaba VisaNet Perú, lo que ya te dice de dónde viene su músculo: red Visa, infraestructura bancaria detrás y presencia en miles de comercios de retail. Para una tienda WooCommerce en Perú es una opción seria, pero no para todos los casos. Acá te cuento qué necesitas, cómo se hace la integración técnica, qué pedir al ejecutivo y en qué momento conviene Niubiz frente a otras alternativas.

Aviso desde el inicio: Niubiz tiene fama de pedir volumen mínimo. Eso no es exacto. Lo que pasa es que las mejores comisiones se reservan para comercios que mueven números altos. Si tienes una tienda pequeña te van a atender igual, pero la cotización inicial puede ser menos atractiva. Hay que saber negociar.

Qué es Niubiz y por qué considerarla

Niubiz procesa pagos con tarjeta Visa, Mastercard, American Express y Diners. Es la procesadora líder en transacciones presenciales en Perú y tiene una plataforma online sólida llamada Niubiz POS Virtual o Niubiz Pasarela, según el producto que contrates. Su backend es estable, los reportes son completos y la conciliación con el banco está bien armada.

Lo que la diferencia de Izipay es el ecosistema. Niubiz tiene acuerdos directos con Visa que le permiten ofrecer programas de cuotas, beneficios de fidelización y promociones especiales que no siempre están disponibles en otras pasarelas. Si tu negocio depende de campañas con bancos (por ejemplo, 12 cuotas sin interés con tarjeta BCP o un dscto especial con Interbank), Niubiz suele tener la ruta más directa.

Requisitos previos para integrar Niubiz

Antes de mover cualquier línea de código en tu WooCommerce, necesitas tener la cuenta comercial aprobada. Esto es lo que te van a pedir.

RUC activo y en estado habido. Si la SUNAT te tiene en suspensión temporal o tu RUC está de baja, olvídate. Ficha RUC vigente, DNI del representante legal, copia literal de partida registral si eres persona jurídica, y comprobante de domicilio fiscal con antigüedad menor a tres meses. Para una persona natural con negocio basta el DNI más la ficha RUC.

También necesitas una cuenta corriente o de ahorros en soles a nombre del titular del RUC. Niubiz abona en cualquier banco peruano. Si tu volumen es alto te conviene una cuenta empresarial que soporte abonos masivos sin retenciones.

En el lado técnico, tu WooCommerce debe correr sobre WordPress 6.0 o superior, PHP 7.4 mínimo (recomendado 8.1), un certificado SSL válido (Niubiz no acepta autofirmados ni de Let’s Encrypt vencidos), y un hosting que responda en menos de dos segundos. Los webhooks de Niubiz tienen timeout corto. Si tu servidor demora, vas a tener pagos huérfanos.

Paso 1: solicitar la afiliación comercial

Niubiz tiene formulario web de contacto comercial. Llenas datos básicos, te llama un ejecutivo, y ahí empieza la conversación. Lleva preparados estos números: volumen mensual estimado, ticket promedio, y porcentaje aproximado de ventas con débito versus crédito.

La comisión de Niubiz suele ubicarse entre 3.49% y 4.99% para débito local, y entre 3.99% y 5.49% para crédito. Estos son rangos de referencia. La realidad es que si mueves menos de 15.000 soles al mes, te van a ofrecer la tabla más alta. Por encima de 50.000 soles puedes pedir un descuento y te lo dan. Por encima de 200.000 soles tienes margen para cerrar comisiones por debajo del 3%, dependiendo del rubro.

El rubro importa. Comercios de tecnología, joyería, viajes y suplementos suelen pagar más por considerarse de mayor riesgo de contracargo. Restaurantes, retail clásico y servicios profesionales suelen pagar menos.

Pregunta también por la mensualidad fija. Niubiz tiene planes con costo cero de mantenimiento y otros con cargo de 30 a 100 soles que incluyen herramientas adicionales como reportes avanzados, API de conciliación o soporte prioritario. Decide según lo que de verdad vas a usar.

Paso 2: obtener llaves API y accesos al panel

Una vez aprobado el contrato, recibes credenciales para dos ambientes: integración (sandbox) y producción. Las llaves que vas a manejar son: merchant ID, access key y secret key. Estas dos últimas funcionan como usuario y clave de API. La secret key no se vuelve a mostrar tras la primera visualización en el panel, así que guárdala bien en un gestor de contraseñas.

Niubiz también te da acceso al portal de comercios donde vas a ver transacciones, reportes diarios, contracargos pendientes y configuración de marcas de tarjeta. Familiarízate con ese panel desde el primer día. Acá vas a vivir buena parte de la operación.

El otro acceso que conviene pedir es al ambiente de pruebas con tarjetas de simulación. Niubiz entrega un listado de tarjetas con CVV y vencimiento ficticios que disparan distintas respuestas: aprobado, denegado por banco, denegado por fraude, denegado por fondos. Vas a usarlas mucho en el paso siguiente.

Paso 3: instalar el plugin de Niubiz para WooCommerce

Niubiz no siempre publica su plugin en el repositorio oficial de WordPress, depende del momento y de la versión del producto. Lo más confiable es pedirlo directamente al área técnica o al ejecutivo asignado. Suelen entregártelo como archivo zip junto con un manual técnico.

Para instalarlo, entras a tu WordPress, Plugins, Añadir nuevo, Subir plugin, eliges el zip y activas. Si tu hosting tiene límite de tamaño de subida, súbelo por FTP a la carpeta wp-content/plugins y actívalo desde el panel.

Hay también soluciones de terceros que integran Niubiz vía su API REST y que se pueden encontrar en marketplaces como CodeCanyon. Si vas por ese camino, valida que el desarrollador mantenga el plugin actualizado y que tenga soporte. Una pasarela mal mantenida es una bomba de tiempo en cualquier checkout.

Paso 4: configurar credenciales y método de pago

Con el plugin activo, ve a WooCommerce, Ajustes, Pagos, y busca el método Niubiz. Actívalo y entra a configurar.

Carga las credenciales del ambiente de integración primero: merchant ID, access key, secret key. Selecciona modo sandbox o pruebas. Define el modo de integración: redirección o ventana modal. La modal queda dentro del flujo de tu tienda y mejora la conversión, pero exige que el sitio no tenga políticas estrictas de Content Security Policy que bloqueen iframes externos. Si tu sitio usa un plugin como WP CSP o uno de seguridad agresivo, primero habilita el dominio de Niubiz como fuente confiable.

Configura qué marcas de tarjeta vas a aceptar. Visa y Mastercard son automáticas. Diners y Amex requieren habilitación adicional y a veces comisión distinta. Activa solo lo que negociaste, no de oficio.

Define la URL de respuesta (la página a la que vuelve el cliente tras pagar) y la URL de notificación o webhook. Esta segunda es crítica. Niubiz golpea esa URL para confirmar el pago aunque el cliente cierre el navegador. Si la URL falla, los pedidos quedan en pendiente y tu operación se rompe.

Paso 5: pruebas en sandbox

Antes de pasar a producción, prueba muchos escenarios. Genera al menos quince pedidos en el ambiente de pruebas. Usa todas las tarjetas que te entregó Niubiz. Asegúrate de probar pagos aprobados, rechazos por fondos, rechazos por antifraude, y pagos con 3D Secure (OTP por SMS o por app del banco).

Revisa estos puntos en cada prueba: el estado del pedido en WooCommerce debe pasar a procesando o completado según corresponda, el correo de confirmación debe llegar al cliente, el stock debe descontarse si aplica, y la boleta o factura debe emitirse si tienes integración con SUNAT. Si alguno de estos pasos falla, no avances. Resuelve antes.

Una prueba que vale la pena: simular un pago y cerrar el navegador en el momento exacto del redirect de vuelta. El webhook debería confirmar la transacción y dejar el pedido como pagado igual. Si no lo hace, hay algo mal en la configuración de la URL de notificación.

Paso 6: pasar a producción

Con todas las pruebas verdes, contactas a tu ejecutivo para que active el ambiente de producción. Te van a pedir capturas de pantalla de las transacciones exitosas en sandbox como evidencia de que la integración funciona. En el plugin, cambias el modo a producción y reemplazas las llaves de sandbox por las definitivas.

Realiza una compra real con tu tarjeta por un monto bajo, por ejemplo 10 soles. Verifica que el cobro aparezca en tu estado de cuenta y que el abono llegue a tu cuenta empresarial. Niubiz suele abonar al día hábil siguiente, con corte al final del día. Una vez confirmado el abono, recién la integración está oficialmente lista.

Comisiones negociables y costos a vigilar

La comisión publicada nunca cuenta toda la historia. Los costos adicionales que conviene revisar antes de firmar son: cargo por contracargo (suele estar entre 30 y 60 soles por disputa), cargo por reposición o reactivación si tu cuenta se suspende temporalmente, costo de los planes de cuotas sin interés (que pagas tú como comercio en forma de porcentaje extra), retenciones del IGV sobre la comisión, y posibles costos de integración técnica si pides ayuda al equipo de Niubiz.

Para un comercio que factura 100.000 soles al mes con ticket promedio de 200 soles, una comisión efectiva total razonable está entre 3.0% y 3.8%. Por debajo de 30.000 soles mensuales, calcula entre 3.8% y 4.8% reales. Estos son rangos prácticos, no oficiales, basados en proyectos que he visto.

Cuándo conviene Niubiz frente a otras opciones

Niubiz tiene sentido cuando tu negocio mueve volumen, cuando quieres aprovechar promociones bancarias con Visa, o cuando ya manejas un POS físico de Niubiz y prefieres consolidar todo bajo el mismo proveedor.

No conviene Niubiz si recién estás empezando con poca facturación y quieres salir a vender en pocos días. El onboarding toma tiempo. Para esos casos, Culqi o Mercado Pago son más rápidos. Tampoco conviene si tu rubro tiene tasa alta de contracargos y necesitas un proveedor más flexible en manejo de disputas.

Mi recomendación práctica: cotiza siempre Niubiz, Izipay y Culqi para el mismo volumen y revisa las tres propuestas en frío. La diferencia entre ellas puede ser de un punto porcentual, lo que en una tienda mediana equivale a varios miles de soles al año.

Errores comunes y soluciones

El error más típico es el pago aprobado en banco pero pendiente en WooCommerce. Casi siempre es problema de webhook: URL mal escrita, certificado SSL inválido, o firewall del hosting bloqueando las IPs de Niubiz. Pide a tu hosting la lista de IPs que necesita autorizar y agrega a la lista blanca.

Otro problema frecuente es el de llave inválida. Pasa cuando copias la secret key con espacios al inicio o final, o cuando confundes el ambiente (estás en producción y pegaste la llave de sandbox). Verifica que el modo del plugin coincida con el set de credenciales.

Mantenimiento y revisión periódica

Después de salir a producción, hay tres tareas mensuales mínimas. Primero, actualizar el plugin si Niubiz publica nueva versión. Segundo, revisar el log de transacciones y conciliar contra los reportes que llegan por correo del portal de Niubiz. Tercero, verificar que no haya pedidos en estado pendiente con más de 24 horas, lo que delata fallos de webhook.

Cada seis meses, sienta a tu ejecutivo a la mesa y pide revisar la comisión. Si tu volumen creció, hay espacio para bajar. Si tu volumen bajó, busca un plan más liviano. Esa renegociación regular es lo que separa a un comercio que paga la tabla pública de uno que paga la real.

Preguntas frecuentes sobre integrar Niubiz con WooCommerce

¿Cuánto demora el proceso completo de aprobación e integración?

Entre dos y cuatro semanas en condiciones normales. La parte técnica se resuelve en uno o dos días. El resto es revisión documental, validaciones de la entidad bancaria detrás de Niubiz y activación de credenciales de producción. Si te falta algún documento, puede estirarse a un mes y medio.

¿Niubiz exige un volumen mínimo de ventas?

No de manera oficial. Atienden comercios de cualquier tamaño. Pero las mejores comisiones se reservan para comercios con volumen alto. Si recién empiezas, te van a cotizar la tabla más alta. Por eso conviene tener una cotización paralela con Izipay y Culqi para usar como referencia en la negociación.

¿Puedo usar Niubiz si soy persona natural sin negocio?

Necesitas RUC activo, así sea de persona natural con negocio. Sin RUC no hay afiliación. Si solo tienes DNI y quieres aceptar pagos con tarjeta, una opción más accesible es Culqi o Mercado Pago, que aceptan personas naturales con menos requisitos.

¿Niubiz se integra con SUNAT para facturación electrónica?

Niubiz procesa el pago. Para emitir comprobante electrónico necesitas un proveedor de facturación separado (NubeFact, FacturaFront, Apifact, o un módulo propio en SUNAT). El plugin debe pasar los datos del cliente al sistema de facturación tras la aprobación del pago. Esa parte se configura aparte y vale la pena tener clara antes de salir a producción.

¿En cuánto tiempo se abona el dinero?

Normalmente al día hábil siguiente, con corte al cierre del día. Pagos hechos en fin de semana se procesan el lunes siguiente. Para cuentas en BCP, BBVA, Interbank y Scotiabank el abono es rápido. Para bancos más chicos puede tomar 48 horas hábiles.

¿Niubiz cobra por cada contracargo o disputa?

Sí. El costo va de 30 a 60 soles por disputa, según contrato. Tienes un plazo de 10 a 15 días hábiles para presentar evidencia de la transacción legítima. Si ganas el caso, el monto del contracargo se devuelve pero el costo administrativo no. Si pierdes, el monto de la venta y la penalidad quedan en tu contra.

¿Puedo aceptar pagos en cuotas sin interés con Niubiz?

Sí, Niubiz tiene programas de cuotas con varios bancos. El interés lo absorbe el comercio como comisión adicional, que va del 4% al 9% según la cantidad de cuotas. Es una herramienta poderosa para subir el ticket promedio, pero hay que calcular bien el impacto en margen antes de activarlo.

¿Qué pasa si mi plugin de Niubiz se desactualiza?

Niubiz publica actualizaciones periódicas. Si tu plugin queda atrás más de seis meses, pueden empezar a aparecer problemas con nuevos estándares de seguridad o cambios en el endpoint del API. Revisa el portal de soporte o pídele a tu ejecutivo el zip más reciente cada cierto tiempo.

¿Cómo se compara Niubiz con Izipay en costos?

En la práctica los rangos son similares. Para volúmenes medios y altos las dos negocian comisiones competitivas. Niubiz suele ganar cuando hay promociones bancarias específicas y cuando el comercio depende de Visa. Izipay suele ganar cuando hay omnicanal con POS físico BCP y cuando se valora más el módulo de facturación SUNAT integrado.

¿Necesito el libro de reclamaciones virtual si uso Niubiz?

Sí, sí o sí. Niubiz procesa pagos, no resuelve esa obligación legal. La Ley 32495 exige que toda tienda peruana tenga libro de reclamaciones virtual visible. Hay plugins gratuitos para WordPress que cumplen con el formato exigido por Indecopi. Tenlo activo antes de procesar tu primera venta real.