API de Asaas: cobros, Pix y webhooks con agentes de IA
La API de Asaas, plataforma brasileña de cobros, es REST y cubre casi todo lo que se hace en el panel: alta de clientes, emisión de cobros, suscripciones, transferencias y facturas fiscales. La usan empresas y desarrolladores que integran el cobro con el ERP, el CRM o un sistema propio, para operaciones en Brasil. El acceso es por la clave de API de la propia cuenta, con un entorno sandbox para pruebas.
Qué ofrece la API de Asaas
Clientes
Registrar, actualizar y buscar pagadores con su ID fiscal (CPF o CNPJ), correo y teléfono.
Cobros
Emitir boleto, Pix o tarjeta, consultar el estado, reembolsar y generar una segunda copia. El boleto es el recibo de pago bancario brasileño y Pix, el pago instantáneo del Banco Central de Brasil.
Suscripciones
Crear cobros recurrentes y ajustar importe, ciclo y vencimiento.
Facturas fiscales
Programar y emitir facturas de servicios vinculadas a los cobros.
Transferencias y saldo
Consultar saldo y extracto, y hacer transferencias y pagos de cuentas.
Webhooks
Recibir eventos como cobro pagado, vencido o reembolsado.
Cómo acceder a la API de Asaas
- Con las credenciales de tu empresaAutenticación con una clave de API (access token) generada en el panel de Asaas, que se envía en la cabecera de cada solicitud. Hay claves separadas para sandbox y producción.
- La clave de API da un acceso amplio a la cuenta, incluidas las transferencias: guárdala solo en la bóveda y bloquea en el agente las acciones que sacan dinero.
- Usa el sandbox para validar el régimen de cobro antes de activarlo en producción.
- El CPF, el teléfono y los datos de pago son personales: trátalos conforme a la LGPD, la ley brasileña de protección de datos.
Documentación oficial: docs.asaas.com
Qué hace un agente de iTeam con la API de Asaas
Régimen de cobro conversado
Al recibir el evento de cobro vencido, el agente envía un recordatorio por WhatsApp con el código de barras o el Pix y registra la respuesta del cliente.
Segunda copia sin cola en finanzas
El cliente pide la segunda copia por correo o por WhatsApp y el agente le devuelve al instante el enlace actualizado del cobro.
Conciliación con el ERP
El agente lee los cobros pagados del día y da de baja los títulos del ERP, separando las diferencias de importe para su revisión.
Descuento con nivel de aprobación
Las solicitudes de descuento o de pago en cuotas se convierten en una propuesta del agente, que finanzas aprueba antes de modificar el cobro.
De la credencial al agente trabajando, con aprobación
Genera la clave de API en Asaas
En el panel de Asaas, genera la clave de API de la cuenta (empieza por el sandbox) y configura la URL de webhook que indique iTeam.
Define permisos por agente
En iTeam, la credencial de Asaas va a la bóveda y cada agente recibe una lista cerrada de acciones (consultar cobros, emitir una segunda copia, crear un cobro). Las acciones que modifican datos requieren la aprobación de una persona.
Valida en pequeño y amplía después
Empieza por un caso: emite un cobro en el sandbox y simula el pago. Con el resultado comprobado, el proceso gana volumen, siempre con auditoría y con aprobación donde haya riesgo.
Equipos de IA listos que usan Asaas
Preguntas sobre la API de Asaas
¿La API de Asaas es gratuita?
No se cobra por usar la API en sí. Pagas las tarifas normales de Asaas por boleto, Pix, tarjeta o factura emitida. Consulta la tabla vigente en el sitio de Asaas.
¿Necesito programar para usar la API de Asaas con iTeam?
No hace falta. iTeam lee la documentación de la API de Asaas, arma las llamadas y el equipo de implantación ajusta el flujo contigo. A la empresa le toca aprobar y hacer seguimiento.
¿Se puede probar la API de Asaas sin mover dinero real?
Sí. Asaas ofrece un entorno sandbox con clave propia, donde iTeam valida el régimen de cobro y los webhooks antes de pasar a producción.
