WooCommerce Andina Culqi Payments

WooCommerce Andina Culqi Payments integra la pasarela de pagos Culqi en tu tienda WooCommerce con un checkout transparente, sin redirigir al cliente a páginas externas. El cliente completa el pago dentro de tu sitio, lo que mejora la confianza y la tasa de conversión.

Desarrollado y mantenido por Andina Digital, el plugin cubre el ciclo completo de pagos para el mercado peruano: desde el cobro con tarjeta hasta la gestión de suscripciones recurrentes con sincronización automática mediante webhooks.

Funcionalidades principales

Pagos con tarjeta

Acepta Visa, Mastercard, American Express y Diners Club a través del checkout transparente de Culqi. El cliente ingresa sus datos directamente en tu sitio, sin abandonar el proceso de compra.

Autenticación 3D Secure

El flujo de autenticación 3DS / MPI se activa de forma automática según el banco emisor. El plugin gestiona la verificación adicional sin que tengas que configurar nada extra.

Tarjetas guardadas

Los clientes registrados pueden guardar sus tarjetas para compras futuras. El token se almacena en Culqi; tu base de datos no guarda información sensible de la tarjeta.

Pago en cuotas

Habilita el pago en cuotas desde la configuración del gateway. El cliente elige el número de cuotas en el modal de pago de Culqi.

Métodos de pago alternativos

Además de tarjetas, puedes activar Yape, Plin, Banca Móvil, Agentes y bodegas, billeteras digitales y Cuotéalo BCP mediante el módulo Culqi Multipayment, sin instalar plugins adicionales.

Reembolsos

Procesa devoluciones totales o parciales desde el panel de pedidos de WooCommerce. El reembolso se registra automáticamente en Culqi y queda asociado a la orden.

Suscripciones recurrentes

Crea y administra planes de cobro recurrente (diario, semanal, mensual o anual) desde el panel de WordPress, sin entrar al panel de Culqi. Puedes vincular un plan a cualquier producto, generar suscripciones con URL de pago directa para enviar al cliente, definir un precio promocional para los primeros ciclos y cancelar suscripciones de forma manual. El estado se sincroniza automáticamente mediante webhooks.

Seguridad de webhooks

Todos los webhooks recibidos de Culqi se verifican con firma RSA-SHA256 para garantizar su autenticidad. En producción, la verificación es obligatoria: si no se ha configurado la clave pública RSA, los eventos se rechazan para impedir notificaciones falsificadas.

Actualizaciones automáticas con licencia

Con tu licencia activa, el plugin recibe nuevas versiones de forma segura y autenticada, igual que cualquier plugin del repositorio oficial. WordPress te avisa cuando hay una actualización disponible y la instalas con un solo clic.

Compatibilidad

• WooCommerce High-Performance Order Storage (HPOS).
• WooCommerce Blocks Checkout y checkout clásico.
• WordPress 6.2 o superior, WooCommerce 6.0 o superior, PHP 8.0 o superior.

Requisitos

Para operar necesitas una cuenta activa en Culqi con tus llaves de API (de prueba y de producción) y una licencia válida de Andina Digital. El módulo de suscripciones requiere que Culqi habilite las rutas recurrentes en tu cuenta de forma separada.

Sobre Andina Digital

Somos una empresa de desarrollo de software con base en Perú, especializada en soluciones WordPress y WooCommerce para el mercado latinoamericano. Brindamos soporte directo y mantenimiento continuo de nuestros productos.

Historial de versiones

1.2.2 (2 junio 2026)

• Se agregó un enlace directo a la documentación en la fila de acciones del plugin, junto a Configurar y Panel.

1.2.1 (2 junio 2026)

• Se corrigió un error crítico en el checkout con WooCommerce Blocks cuando el plugin estaba instalado sin licencia activa.
• Se añadió la redirección automática a la página de licencia tras la primera activación.
• Se incorporó una telemetría diaria de estado del sitio hacia Andina Digital.
• La página de gestión de licencia se alineó con el diseño estándar de Andina Digital.

1.2.0 (mayo 2026)

• Sistema de licencias con activación, validación periódica y actualizaciones automáticas autenticadas.
• Nueva página de gestión de licencia con estado, tipo y vigencia.
• Verificación de firma del webhook obligatoria en producción.
• Mejoras de seguridad en la eliminación de tarjetas guardadas y de rendimiento en el historial de webhooks.

1.1.0 (11 mayo 2026)

• Módulo completo de suscripciones recurrentes con panel de planes y suscripciones independientes.
• Precio promocional inicial por plan, cancelación manual y sincronización automática por webhooks.
• Historial de eventos de suscripciones y verificador del módulo recurrente de Culqi.

1.0.0 (6 mayo 2026)

• Versión inicial con checkout transparente, 3D Secure, tarjetas guardadas, cuotas y métodos alternativos.
• Reembolsos desde el panel de pedidos, webhooks con firma RSA-SHA256 y compatibilidad con HPOS y WooCommerce Blocks.

Preguntas frecuentes

¿Qué llaves de Culqi necesito para empezar?
Necesitas cuatro llaves desde tu panel en culqi.com: la pública y secreta de prueba (pk_test y sk_test) y la pública y secreta de producción (pk_live y sk_live). Las de prueba sirven para validar el plugin sin cobros reales.

¿El cliente sale de mi sitio para pagar?
No. El checkout transparente de Culqi permite que el cliente complete el pago dentro de tu tienda, sin redirecciones a páginas externas.

¿Es compatible con el checkout de bloques de WooCommerce?
Sí. Funciona con el checkout clásico y con el bloque de checkout, y es compatible con HPOS.

¿Se guardan datos de tarjeta en mi base de datos?
No. Los datos se tokenizan en el navegador del cliente mediante los scripts de Culqi antes de llegar a tu servidor. El plugin no almacena números de tarjeta, CVV ni fechas de vencimiento.

¿Cómo activo el módulo de suscripciones recurrentes?
El módulo viene incluido, pero Culqi debe habilitar las rutas recurrentes en tu cuenta de forma manual. Contacta a su soporte indicando tu llave pública para que activen el servicio.

¿Por qué debo configurar la clave pública RSA del webhook?
Permite verificar la firma de cada webhook y confirmar que el evento es auténtico. En producción la verificación es obligatoria por seguridad.

¿Cómo recibo las actualizaciones del plugin?
Con tu licencia activa, WordPress te notifica cuando hay una nueva versión y la instalas con un clic, igual que cualquier otro plugin.

¿Puedo procesar reembolsos desde WooCommerce?
Sí. Puedes emitir reembolsos totales o parciales desde el panel de pedidos. El reembolso se registra automáticamente en Culqi.

¿En cuántos sitios puedo usar una licencia?
Cada licencia define un número máximo de activaciones. Si mueves el plugin a otro dominio, desactiva primero la licencia en el sitio actual para liberar el cupo.