Flutterwave y WhatsApp: el agente de IA envía el payment link de Flutterwave en el chat
Actualizado el 25 de octubre de 2026 · Revisado por Alejandro Díaz, CEO de Agent IA SAS
Flutterwave es una plataforma de pagos africana en la que el comprador paga con tarjeta, transferencia bancaria, USSD, mobile money como M-Pesa, QR u OPay, según la moneda. En SoyAgentia viene nativa en el panel. Cuando un cliente decide comprar por WhatsApp, el agente de IA arma el pedido con tu catálogo, crea el pago en tu cuenta de Flutterwave y le envía el link en la misma conversación. El dinero llega a tu cuenta de Flutterwave.
Sirve, por ejemplo, a una empresa latinoamericana que vende a compradores en África con una cuenta de Flutterwave, o a un comercio que ya cobra con Flutterwave y quiere vender por chat. Si comparas opciones, mira Paystack y el resto de pasarelas de pago.
Qué hace el agente de IA con Flutterwave
El agente cobra dentro del chat. Con cada pedido hace esto:
- Arma el pedido con productos del catálogo, servicios o montos a la medida, como un anticipo o una cotización. Varios productos van en un solo link por el total, que el cliente paga con un clic.
- Crea un pago en Flutterwave Standard con la referencia del pedido (tx_ref), el monto, la moneda de cobro, el correo y, si los tiene, el nombre y el celular del cliente. Flutterwave devuelve el link de su página de pago.
- Envía el link en el chat con el monto. Antes de enviar el mensaje, la plataforma verifica que el link lo haya creado ella: tu cliente solo recibe links legítimos de tu cuenta.
- Cuando el pago se aprueba, el cliente recibe la confirmación en WhatsApp, el inventario se descuenta y la venta se factura sola en tu ERP. El cliente recibe el PDF de la factura por WhatsApp.
Cómo conectar Flutterwave a tu WhatsApp
En SoyAgentia entra a Negocio → Integraciones, pestaña «Pasarela de pagos», y elige Flutterwave.
- En el Dashboard de Flutterwave abre Settings → API Keys, en la sección de desarrolladores, y copia la Secret Key. El interruptor de Live y Test cambia las llaves; las de pruebas llevan _TEST en el prefijo.
- La plataforma usa Flutterwave Standard de la API v3: si tu dashboard muestra la v4, con el Client ID y el Client Secret, cambia a la v3 y copia la Secret Key de esa versión.
- Pega la llave y toca «Guardar y validar». La plataforma la prueba consultando los saldos de tu cuenta, rechaza la Public Key y te avisa si la llave no es del ambiente elegido.
- En Settings → Webhooks pega la URL que te muestra el panel, escribe un secret hash, que es un texto largo al azar, y activa los reintentos. Copia ese mismo secret hash en el panel.
- Opcional: escribe un «Correo para clientes sin correo». Luego elige la moneda de cobro y la de tus precios, y toca «Activar», o asigna la cuenta por línea o como respaldo.
Paso a paso del cobro con Flutterwave
Desde que el cliente confirma hasta que el pedido queda pagado:
- El agente pide el link y Flutterwave devuelve la URL de su página de pago.
- El cliente paga. Flutterwave lo redirige a una página de la plataforma con el estado y la referencia en la URL, y la plataforma verifica la transacción con Flutterwave antes de aprobar, como recomienda la guía de Flutterwave Standard.
- Flutterwave avisa al webhook con tu secret hash en el encabezado verif-hash. La plataforma lo compara y, si coincide, verifica la transacción por su referencia con tu Secret Key.
- Solo aprueba si la transacción salió exitosa, en la misma moneda y por al menos el monto que pediste.
- Si un aviso se pierde, los reintentos de Flutterwave y la conciliación cada 10 minutos cierran el pedido.
Monedas: por qué conviene cobrar en la moneda del comprador
En el panel eliges la «Moneda de cobro» entre 15 monedas, entre ellas NGN, USD, GHS, KES, ZAR, UGX, TZS, RWF, XOF, XAF, EGP, EUR y GBP. Por defecto queda en USD.
Flutterwave ata algunos medios a su moneda y oculta los que no aplican, según su página de medios de pago. En dólares, el cliente ve tarjeta y cuenta bancaria; M-Pesa solo aparece en KES y el mobile money de cada mercado, en su moneda. Si vendes a compradores que pagan con el celular, cobra en su moneda.
Si tus precios están en otra moneda, la plataforma convierte con la tasa del día: tasa diaria de mercado para nairas, chelines, cedis y francos CFA, referencia del Banco Central Europeo para el rand y el euro, y TRM oficial para pesos colombianos. Puedes fijar una tasa y un recargo por conversión. Detalle en cobrar en dólares por WhatsApp.
Medios de pago que verá tu cliente en Flutterwave
Flutterwave muestra los medios que apliquen a la moneda y que tengas activos en las preferencias de tu cuenta:
- Tarjetas de crédito y débito.
- Transferencia bancaria y débito de cuenta bancaria.
- USSD: el cliente marca desde su celular el código de su banco.
- Mobile money: M-Pesa y las billeteras móviles de varios mercados.
- QR, OPay y, en libras egipcias, FawryPay.
Ventajas de conectar Flutterwave con WhatsApp
Esto es lo que suma a tu operación:
- Lo que necesitas: la Secret Key de la API v3. Flutterwave Standard es la página de pago hospedada que usa la plataforma, con los medios de cada moneda.
- Verificación en cada pago: Flutterwave envía el secret hash tal cual, así que la plataforma confirma cada transacción con tu Secret Key antes de aprobarla.
- Ninguna venta se pierde por tiempo: si el cliente no ha pagado, el agente le envía un recordatorio automático en el chat, y si paga después de las 24 horas del pedido, el pago se registra igual cuando Flutterwave avisa.
- Cobra productos del catálogo, servicios y montos a la medida (anticipos, abonos, cotizaciones), también los productos sincronizados desde Shopify, en WhatsApp, Instagram, Messenger y TikTok.
- Los reembolsos y anulaciones que hagas en Flutterwave se reflejan en el panel: la venta cambia de estado y el inventario se repone. Contracargos y comisiones siguen tu contrato con Flutterwave.
- Respaldo automático entre pasarelas y reportes de ventas por pasarela: si Flutterwave no responde, el cobro pasa a tu siguiente cuenta, y el panel te muestra cuánto cobró cada una, por línea y por periodo.
- Flutterwave es una marca del grupo Flutterwave. SoyAgentia no está afiliada a Flutterwave.
Integraciones disponibles
- Flutterwave Standard (API v3)
- WhatsApp Business API (Cloud API)
- ERP activo para facturar (Siigo u otro conectado)
Sigue leyendo
Preguntas frecuentes
¿Qué llave de Flutterwave conecto en el panel?
La Secret Key de la API v3, que es la que usa Flutterwave Standard. Si tu panel muestra el Client ID y el Client Secret de la v4, cambia a la v3 en el dashboard y copia la Secret Key de esa versión. Al guardarla, la plataforma la prueba con Flutterwave y la deja cifrada.
¿Cómo hago para que mi cliente pague con M-Pesa en Flutterwave?
Cobra en chelines kenianos. Flutterwave muestra M-Pesa en los pagos en KES y adapta los medios a la moneda de cada pago. Cambia la moneda de cobro de la cuenta a KES y la plataforma convierte tus precios con la tasa del día. En dólares, el cliente ve tarjeta y cuenta bancaria.
¿Para qué activo los reintentos del webhook en Flutterwave?
Para que ningún aviso se pierda. Con los reintentos activos, Flutterwave reenvía un aviso fallido hasta tres veces, con 30 minutos entre cada intento, según su guía de webhooks. Además, la conciliación de la plataforma consulta los pagos pendientes cada 10 minutos.
¿Qué correo usa Flutterwave si el cliente no me lo dio por WhatsApp?
El agente le pide el correo al cliente de forma natural, y el suyo siempre tiene prioridad. Si prefiere no darlo, se usa tu «Correo para clientes sin correo» con un sufijo por cliente, por ejemplo ventas+wa573001234567@tutienda.com. Si dejas ese campo vacío, la plataforma usa una dirección técnica propia.