Gustavo Vargas Rubiano
Proyectos

Pasarela de pago propia para ecommerce vía WhatsApp con IA embebida

WhatsPay

WhatsPay lo armé porque las tiendas headless que manejo perdían pedidos por WhatsApp: mensajes sueltos sin número de orden, sin inventario descontado, sin seguimiento. Lo construí como gateway real de WooCommerce, cuando el cliente lo elige, la orden queda reservada como con cualquier pasarela, el cliente coordina el pago por WhatsApp con la tienda, y el gestor confirma cuando el depósito llega al banco. Cuando el pago no llega dentro del plazo, un LLM (Gemini) genera y dispara un mensaje contextual al cliente según el estado del pedido: el recordatorio se arma con IA en cada caso, sin plantillas estáticas. En producción en Imbra, Mapache, Saprix y FSO Force. Actualmente desarrollo plugins nativos para WordPress y Shopify para que cualquier ecommerce pueda sumar WhatsPay como pasarela independiente.

El problema

No todos los clientes de una tienda headless quieren o pueden pagar con pasarela tradicional, pero un pedido por WhatsApp sin ningún sistema detrás significa perder el número de orden, el control de inventario y el seguimiento. Es un mensaje suelto, no una venta registrada.

La solución

Gateway real de WooCommerce

  • Clase propia que extiende WC_Payment_Gateway: WhatsPay aparece en el checkout como cualquier otra pasarela, con ícono, título y descripción configurables desde WordPress.
  • Al completar la compra, la orden se reserva en WooCommerce (estado on-hold) y el inventario se descuenta por el mecanismo nativo de WooCommerce, no por un hack aparte.
  • Compatibilidad hacia atrás cuidada: el sistema reconoce tres identificadores históricos del mismo método de pago (evolucionó de nombre con el tiempo) para que ningún pedido viejo quede huérfano.

Doble panel de operación

  • Panel de administración dentro de WordPress: cola de verificación con totales abiertos/confirmados, estado por pedido y botones de una acción (Validar, Confirmar, Fallo).
  • El mismo panel existe también dentro del sitio headless en Next.js, hablando directo contra la API REST de WooCommerce: dos interfaces, una sola fuente de verdad. Cada actualización se refleja además en Supabase.

Coordinación por WhatsApp

  • El pedido genera un mensaje de WhatsApp completo y ya redactado: cliente, cédula, dirección, cada producto con imagen y variante, subtotal, descuentos aplicados, envío y total.
  • El panel de la tienda tiene el enlace en sentido inverso: un botón por pedido que abre WhatsApp con el cliente correcto y la referencia correcta ya escrita, para coordinar el cobro por Nequi.
  • Cuando el pago no llega dentro del plazo, un LLM (Gemini) genera y dispara un mensaje contextual al cliente según el estado del pedido: el recordatorio se arma con IA en cada caso, sin plantillas estáticas.

En producción en 4 tiendas

  • En producción en Imbra, Mapache, Saprix y FSO Force. Actualmente desarrollo plugins nativos para WordPress y Shopify para que cualquier ecommerce pueda sumar WhatsPay como pasarela independiente.