API de Vindi: qué puedes hacer y cómo usarla con agentes de IA
La API de Vindi permite gestionar cobros recurrentes y únicos: clientes, planes, suscripciones, facturas y medios de pago. Vindi es una plataforma brasileña de cobros, así que esta guía es para empresas que cobran en Brasil. La usan empresas de suscripción, SaaS, escuelas y servicios con cuota mensual. El acceso se hace con la clave de API de la cuenta, con entorno sandbox.
Qué ofrece la API de Vindi
Clientes
Alta y actualización de clientes y de sus datos de cobro.
Planes y productos
Configuración de lo que se vende y de su periodicidad.
Suscripciones
Creación, modificación y cancelación de suscripciones recurrentes.
Facturas y cobros
Consulta de facturas, intentos de cobro y estado de pago.
Webhooks
Eventos como factura creada, pago aprobado o rechazado y suscripción cancelada.
Cómo acceder a la API de Vindi
- Con las credenciales de tu empresaUsa una clave de API privada generada en el panel de Vindi, enviada con autenticación básica, con claves distintas para sandbox y producción.
- La clave privada da acceso amplio a la cuenta: guárdala solo en la bóveda y cámbiala si se filtra.
- No pidas datos de tarjeta a través del agente: usa la página de pago de Vindi.
- Los datos de clientes y de cobros están sujetos a la ley brasileña de protección de datos (LGPD).
Qué hace un agente de iTeam con la API de Vindi
Tarjeta rechazada, cliente avisado
Cuando falla el cobro, el agente avisa al cliente por su canal preferido, explica el motivo y envía el enlace para actualizar la tarjeta.
Retención en la cancelación
Las solicitudes de cancelación pasan por el agente, que revisa el historial y ofrece las alternativas aprobadas antes de cancelar.
Cambio de plan asistido
El agente prepara el upgrade o el downgrade con el cálculo de la diferencia y lo ejecuta tras la confirmación del cliente y de finanzas.
Informe de ingresos recurrentes
Cada semana, el responsable recibe las nuevas suscripciones, las cancelaciones, los fallos de cobro y los importes en riesgo.
De la credencial al agente trabajando, con aprobación
Genera la clave en Vindi
En el panel de Vindi, crea la clave de API, empezando por el sandbox.
Regístrala en la bóveda y define límites
La clave queda en la bóveda de iTeam. Las consultas son libres, y los cambios de suscripción y los reembolsos requieren aprobación.
Webhooks y validación
Configura los webhooks de cobro, valida los flujos en el sandbox y después cambia a la clave de producción.
Equipos de IA listos que usan Vindi
Preguntas sobre la API de Vindi
¿La API de Vindi es gratuita?
En general la API forma parte del servicio contratado. Los costos vienen del plan y de las tarifas de cobro acordadas con Vindi.
¿Necesito programar para usar la API de Vindi 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 las reglas.
¿Vindi tiene sandbox?
Sí, hay un entorno de pruebas para validar cobros antes de usar la cuenta real.
