Cómo integrar Izipay con WooCommerce paso a paso

Cuando un cliente quiere pagar con tarjeta en una tienda peruana, hay varios caminos. Izipay es uno de los más usados por comercios medianos y grandes en el país. Tiene respaldo del BCP, una red sólida, integración con SUNAT para facturación electrónica y, lo más importante para muchos dueños de negocio, comisiones que se pueden negociar cuando el volumen acompaña. En este artículo te cuento cómo conectar Izipay a tu tienda WooCommerce sin que sea un dolor de cabeza, qué pedir antes de firmar y cómo evitar los errores que veo seguido en proyectos reales.

Te aviso desde ya: el proceso no es 100% técnico. Buena parte se decide en la conversación con el ejecutivo comercial. Si llegas a la mesa sin saber qué pedir, terminas con una comisión más alta de la que merece tu negocio.

Por qué elegir Izipay para una tienda WooCommerce

Izipay nació de la fusión entre Procesos MC y la antigua red del BCP, y hoy procesa pagos para una parte importante del comercio peruano. Su fuerza está en lo omnicanal. Si tu negocio vende también en local físico con POS, te conviene tener todo en la misma cuenta: cierras un solo lote diario, ves la conciliación en un solo panel y negocias una sola comisión con un mismo ejecutivo. Para una tienda online pura tiene sentido también, sobre todo si esperas un ticket promedio mediano o alto y trabajas con facturación electrónica desde el día uno.

La integración con SUNAT es otro punto a favor. Izipay tiene su propia plataforma de facturación y permite que cada transacción aprobada dispare la emisión de boleta o factura automáticamente. Eso te ahorra el típico paso intermedio de pegar manualmente los datos en otro sistema o de contratar un tercero para cerrar el flujo.

El punto débil que conviene tener claro: el onboarding no es inmediato. Si vienes acostumbrado a Mercado Pago o Culqi, donde abres cuenta y en horas estás procesando, acá el ritmo es distinto. Hay validación de documentos, visita comercial en algunos casos y un proceso de aprobación que suele tomar entre cinco y quince días hábiles.

Requisitos antes de empezar la integración

Antes de tocar el WordPress conviene tener listo todo lo administrativo. Esto te evita pausas largas en medio del proyecto.

Necesitas RUC activo de la empresa o persona natural con negocio, ficha RUC vigente y datos del representante legal. Te van a pedir DNI escaneado por ambos lados, recibo de servicios reciente del domicilio fiscal y, según el caso, vigencia de poder. Si es una SAC o SRL, ten lista la copia literal de la partida registral.

También necesitas una cuenta corriente en soles, idealmente en BCP por temas de velocidad de abono, aunque Izipay deposita en cualquier banco peruano. Define desde el inicio si vas a vender con boleta, factura o ambas, y si necesitas guías de remisión electrónicas. Estos detalles condicionan qué módulo te activan.

En el lado técnico necesitas un WooCommerce funcionando con WordPress 6.0 o superior, PHP 7.4 como mínimo (idealmente 8.1 o 8.2), certificado SSL válido en todo el dominio y un plan de hosting que no se cuelgue al primer pico de tráfico. Izipay no procesa pagos sobre conexiones inseguras y sus webhooks fallan si el servidor responde lento. Si tu hosting es de 15 soles al mes, considera mudar antes de integrar.

Paso 1: solicitar la cuenta comercial de Izipay

Entra a la web de Izipay y solicita asesoría comercial. En la siguiente llamada o reunión, deja claras tres cosas: que la tienda es online sobre WooCommerce, el volumen mensual estimado en soles y el ticket promedio que esperas mover. Con esos tres datos el ejecutivo arma una propuesta económica realista.

Acá viene un consejo que vale oro. Pide siempre dos comisiones distintas: una para Visa y Mastercard tradicionales y otra para tarjetas internacionales o premium. La comisión estándar para débito local suele ubicarse entre 3.5% y 4.5%, y para crédito entre 4% y 5%. Si tu volumen supera los 30.000 soles mensuales, hay margen real para negociar a la baja. No firmes la primera propuesta. Cotiza también con Niubiz y Culqi para tener referencia y vuelve a la mesa con esos números.

Paso 2: obtener credenciales y plugin oficial

Una vez aprobada la cuenta, recibes acceso al Back Office de Izipay y un set de credenciales: usuario tienda, clave de cliente (también llamada shop key) y certificado HMAC SHA-256 para validar firmas. Para el ambiente de pruebas te entregan credenciales separadas. Guarda todo en un gestor de contraseñas, no en un correo perdido.

El plugin oficial se llama Izipay para WooCommerce y está publicado en el repositorio de WordPress. Busca siempre la versión publicada por Izipay directamente. Hay clones y forks de terceros que prometen lo mismo pero no reciben mantenimiento.

Para instalarlo, entra al panel de WordPress, ve a Plugins, Añadir nuevo, busca Izipay y dale a instalar y activar. Si el plugin no aparece, puedes descargarlo desde el portal de soporte de Izipay y subirlo manualmente como archivo zip.

Paso 3: configurar el plugin en WooCommerce

Con el plugin activo, ve a WooCommerce, Ajustes, Pagos. Vas a ver Izipay listado entre los métodos disponibles. Actívalo y entra a la configuración.

Acá completas el usuario tienda, la clave de cliente y la clave HMAC que te entregaron. Selecciona el modo Pruebas para empezar. Define el modo de integración. Izipay ofrece dos opciones: redirección (el cliente sale de tu tienda, paga en el dominio de Izipay y vuelve) o iframe embebido (el formulario de pago aparece dentro de tu propio sitio). El iframe da mejor experiencia y mejora conversión, pero exige que el certificado SSL y la política de Content Security Policy estén bien configurados. Si no estás seguro, empieza con redirección y luego migra.

Habilita las marcas de tarjeta que quieres aceptar: Visa, Mastercard, American Express y Diners. American Express y Diners suelen tener comisiones más altas, así que decide si te conviene activarlas según tu margen.

Configura la URL de respuesta y la URL de notificación IPN. La de respuesta es donde el cliente vuelve tras pagar. La IPN es la que Izipay golpea por detrás para confirmar el pago aunque el cliente cierre el navegador. Si la IPN no funciona, vas a tener pedidos pagados que quedan en estado pendiente en WooCommerce y eso es un caos operativo.

Paso 4: probar en ambiente de sandbox

Antes de poner esto en producción, prueba a fondo. Izipay entrega tarjetas de prueba que simulan distintos escenarios: pago aprobado, pago rechazado por fondos insuficientes, pago rechazado por antifraude y pago con OTP. Pásalas todas.

Genera al menos diez pedidos de prueba con productos distintos, montos distintos y combinaciones de cupones si los usas. Verifica que el estado del pedido cambie correctamente en WooCommerce, que se genere la boleta o factura si tienes integración con SUNAT, y que el correo de confirmación llegue al cliente. Si usas un plugin de inventario, confirma que el stock se descuente.

Una prueba que muchos olvidan: simular que el cliente cierra el navegador justo después de pagar. La IPN debería marcar el pedido como pagado igual. Si no lo hace, hay algo mal configurado y vas a tener problemas serios apenas entres a producción.

Paso 5: pasar a producción

Cuando todas las pruebas pasan, contactas a tu ejecutivo de Izipay para que active el modo producción. Te van a pedir capturas o evidencia de que la integración funciona en sandbox. En el plugin, cambias el modo de Pruebas a Producción y reemplazas las credenciales por las definitivas.

Haz una primera compra real con tu propia tarjeta por un monto pequeño, por ejemplo 5 soles. Verifica que el abono llegue a tu cuenta bancaria. Izipay normalmente abona en 24 a 48 horas hábiles, dependiendo del banco destino y del horario de corte. Una vez confirmado el abono, recién considera la integración lista.

Mantén el modo Pruebas activo en un entorno de staging si trabajas con un desarrollador. Vas a necesitar ese ambiente cada vez que actualices el plugin o cambies algo en el checkout.

Comisiones reales y costos ocultos

La comisión publicada no es la única plata que se va. Hay cargo mensual por mantenimiento de la cuenta, que puede ir de cero a 80 soles según el plan. Hay costo por cada notificación de contracargo. Hay un porcentaje adicional si aceptas pagos en cuotas sin interés (que en realidad las paga el comercio) y hay retenciones del IGV sobre la comisión, que suman al costo real.

Si negocias bien, una tienda con 50.000 soles mensuales de facturación puede llegar a comisiones efectivas de 3.2% a 3.8% sumando todo. Por debajo de los 20.000 mensuales, calcula que vas a pagar entre 4% y 5% reales. Estos números cambian, pero te dan un marco para evaluar la propuesta que recibas.

Integración con SUNAT y facturación electrónica

Si vas a emitir boletas y facturas automáticamente desde WooCommerce, tienes dos rutas. La primera es usar el módulo de facturación de Izipay, que se contrata aparte y se integra al flujo de pago. La segunda es usar un plugin de terceros como FacturaFront o NubeFact y mantener Izipay solo para procesar pagos. Las dos funcionan. La primera es más cómoda si todo está bajo el paraguas de Izipay, la segunda da más flexibilidad si ya tienes un proveedor de facturación que te gusta.

Sea cual sea el camino, confirma que los datos del comprador se pasen correctamente: tipo de documento (DNI o RUC), número, nombre o razón social, y dirección. WooCommerce por defecto no pide RUC, así que vas a necesitar un plugin que añada ese campo al checkout. Sin RUC, no puedes emitir factura.

Errores comunes y cómo resolverlos

El error más frecuente es que el pedido queda en estado pendiente aunque el cliente sí pagó. Casi siempre es porque la URL de IPN está mal configurada, el servidor tarda demasiado en responder o un firewall bloquea las IPs de Izipay. Revisa los logs del plugin (WooCommerce, Estado, Registros) y ubica las entradas marcadas como izipay-gateway. Ahí está la pista.

Otro error típico es el de firma inválida. Pasa cuando el HMAC configurado no coincide con el que Izipay tiene en su lado, o cuando hay un espacio en blanco copiado por accidente al pegar la clave. Vuelve a pegarla limpia, sin saltos de línea.

Si los pagos en iframe no se renderizan, suele ser un conflicto con un plugin de seguridad o de caché. Desactiva temporalmente Wordfence o WP Rocket y prueba de nuevo. Si funciona sin ellos, agrega Izipay a la lista blanca.

Mantenimiento mensual recomendado

Una vez en producción no te olvides de la integración. Cada mes conviene revisar tres cosas: que las versiones del plugin y de WooCommerce estén al día, que los logs no muestren errores nuevos y que la conciliación entre los reportes de Izipay y los pedidos de WooCommerce cuadre. Si encuentras diferencias, atácalas rápido antes de que se acumulen.

Cada seis meses, vuelve a negociar la comisión. Si tu volumen creció, tienes argumento para bajar uno o dos décimos porcentuales. Eso, en una tienda mediana, son miles de soles al año.

Preguntas frecuentes sobre integrar Izipay con WooCommerce

¿Cuánto tarda el proceso completo de integración?

Si tienes todos los documentos listos, calcula entre dos y tres semanas. La parte técnica se resuelve en uno o dos días. Lo que toma tiempo es la aprobación comercial y la activación de credenciales de producción. Si tu negocio recién está formándose o falta algún documento legal, puede estirarse a un mes.

¿Necesito un programador para integrar Izipay con WooCommerce?

No necesariamente. El plugin oficial está pensado para que un dueño de negocio con manejo básico de WordPress lo configure. Si tu tienda es estándar y no tienes un checkout personalizado, lo puedes hacer tú mismo. Si tienes temas personalizados, plugins de membresías o un checkout muy modificado, sí conviene tener apoyo técnico para evitar conflictos.

¿Izipay cobra una cuota mensual fija?

Depende del plan que negocies. Algunos contratos incluyen cero costo fijo y solo se cobra por transacción. Otros tienen una mensualidad de mantenimiento de 30 a 80 soles. En ambos casos hay comisión por transacción aprobada. Pregunta por las dos modalidades y elige según tu volumen esperado.

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

Sí, Izipay soporta cuotas sin interés en tarjetas de crédito de varios bancos. El interés lo paga el comercio en forma de comisión adicional que va del 4% al 9% según la cantidad de cuotas. Es una buena herramienta para subir el ticket promedio, pero calcula el impacto en tu margen antes de activarla.

¿En cuánto tiempo se abona el dinero en mi cuenta bancaria?

Para cuentas en BCP el abono suele ser al día hábil siguiente. Para cuentas en otros bancos peruanos puede tomar entre 48 y 72 horas hábiles. Los pagos hechos en fin de semana o feriado se procesan el siguiente día hábil.

¿Qué pasa si un cliente hace un contracargo o chargeback?

Izipay te notifica por correo y a través del Back Office. Tienes un plazo (normalmente entre 10 y 15 días hábiles) para presentar evidencia: comprobante de envío, conversaciones, copia del DNI verificado en la compra. Si no respondes a tiempo, el cargo se revierte automáticamente y pierdes la venta más una penalidad fija que ronda los 30 a 50 soles.

¿Sirve Izipay si recién estoy empezando con poca facturación?

Sirve, pero no será tu opción más eficiente. Si recién abres tu tienda y esperas vender 3.000 o 5.000 soles al mes, las comisiones serán más altas y el proceso de onboarding más pesado de lo que necesitas. En esos casos suele convenir empezar con Culqi o Mercado Pago, que son más rápidos de activar, y migrar a Izipay cuando el volumen crezca.

¿Puedo tener Izipay y otra pasarela activas al mismo tiempo?

Sí, y en muchos casos es la mejor estrategia. Puedes ofrecer Izipay como método principal para tarjeta, Yape o Plin para pagos rápidos por móvil y una pasarela alternativa de respaldo. WooCommerce permite múltiples métodos de pago activos sin problema. Lo único que debes vigilar es la conciliación, porque cada pasarela tendrá su propio reporte.

¿Izipay funciona con la nueva ley del libro de reclamaciones virtual?

Izipay procesa los pagos. El libro de reclamaciones virtual es responsabilidad tuya y debe estar visible en tu sitio según la Ley 32495. Hay plugins gratuitos y de pago que lo agregan a WooCommerce. Asegúrate de tenerlo antes de salir a producción, porque Indecopi sí está fiscalizando.

¿Qué hago si el plugin oficial de Izipay deja de actualizarse?

Mantente al tanto de los anuncios en el portal de Izipay y revisa el repositorio de WordPress. Si pasa más de un año sin actualizaciones y empiezan a aparecer problemas de compatibilidad con WooCommerce, contacta a soporte para que te confirmen la ruta oficial. En casos extremos puede ser necesario migrar a una integración a medida vía la API REST de Izipay, lo que requiere desarrollador.