API de Iugu: qué puedes hacer y cómo usarla con agentes de IA
La API de Iugu permite emitir facturas, gestionar suscripciones y clientes y recibir avisos de pago. Iugu es una plataforma brasileña de cobros, así que esta guía es para empresas que cobran en Brasil. La usan empresas de servicios, SaaS y plataformas con cobro recurrente o marketplace. El acceso se hace con el token de API de la cuenta, con modo de prueba.
Qué ofrece la API de Iugu
Facturas
Emisión de facturas con boleto, Pix o tarjeta y consulta de su estado. El boleto y el Pix son medios de pago típicos de Brasil.
Suscripciones y planes
Cobro recurrente con planes, suspensión y reactivación.
Clientes
Alta y medios de pago guardados.
Subcuentas
Recursos de marketplace para repartir pagos a terceros.
Disparadores
Notificaciones de eventos como factura pagada, vencida o cancelada.
Cómo acceder a la API de Iugu
- Con las credenciales de tu empresaUsa un token de API generado en el panel de Iugu, con tokens distintos para prueba y producción, enviado con autenticación básica.
- No mezcles los tokens de prueba y de producción.
- Las cancelaciones y los reembolsos deben tener aprobación y un tope de importe.
- Los datos de clientes y de cobros están sujetos a la ley brasileña de protección de datos (LGPD).
Documentación oficial: dev.iugu.com
Qué hace un agente de iTeam con la API de Iugu
Duplicado de factura sin filas
El cliente pide el duplicado por WhatsApp y el agente localiza la factura y envía el boleto o el Pix actualizado.
Régimen de cobranza
El agente sigue el régimen definido por finanzas, con mensajes antes y después del vencimiento, y se detiene cuando el disparador confirma el pago.
Suscripción suspendida con contexto
Antes de suspender por mora, el agente revisa el historial y propone una negociación dentro de las reglas aprobadas.
Cierre del mes
Finanzas recibe las facturas pagadas, abiertas y vencidas del mes, con el total por plan.
De la credencial al agente trabajando, con aprobación
Genera los tokens en Iugu
En el panel de Iugu, crea los tokens de prueba y de producción para la integración.
Regístralos en la bóveda de iTeam
Los tokens quedan en la bóveda. Emitir un duplicado puede ser automático, mientras que cancelar y reembolsar exige aprobación.
Prueba en el modo de prueba
Ejecuta facturas y disparadores en el modo de prueba antes de usar el token de producción.
Equipos de IA listos que usan Iugu
Preguntas sobre la API de Iugu
¿La API de Iugu es gratuita?
En general la API forma parte del servicio. Los costos son las tarifas por factura y por medio de pago del plan contratado con Iugu.
¿Necesito programar para usar la API de Iugu con iTeam?
No necesariamente. La herramienta HTTP de iTeam aprende los endpoints a partir de la documentación y el equipo de implantación configura el régimen de cobranza.
¿Iugu tiene entorno de pruebas?
Sí, hay un modo de prueba con token propio para simular facturas y pagos.
