Finanzas y pagos
Asaas en tu producto y en tus agentes de IA, con una API
El toolkit de Asaas cubre clientes, cobros (cobrancas) y suscripciones: listar, consultar, crear y actualizar, además de eliminar cobros. Connect guarda la clave de API de cada cliente, registra cada ejecución y expone cada operación como una tool con JSON Schema, para que tu producto o agente de IA cobre con Asaas sin construir la integración.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/asaas_create_customer/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>",
"cpfCnpj": "<cpfCnpj>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Asaas.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Asaas. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Asaas.
Cobrar desde tu SaaS
Crea un cliente y un cobro por boleto, Pix o tarjeta de crédito, y envía al pagador el invoiceUrl que devuelve Create payment.
Planes recurrentes en Asaas
Crea una suscripción para un cliente y deja que Asaas genere un cobro por ciclo; lee esos cobros con List payments filtrando por suscripción.
Agente de cobranza para finanzas
Un agente de IA lista los cobros vencidos, consulta cada uno y actualiza la fecha de vencimiento o elimina el cobro, todo registrado en la auditoría de Connect.
Tools
12 tools de Asaas
- Listar clientesGETLista los clientes (pagadores) de la cuenta, con filtro opcional por nombre, email, CPF o CNPJ, grupo o referencia externa. La respuesta trae data, totalCount y hasMore; pagina con offset y limit mientras hasMore sea true.
- Consultar clienteGETDevuelve un cliente, con nombre, CPF o CNPJ, email, teléfonos, dirección y configuración de notificación.
- Crear clientePOSTCrea un cliente, el pagador de cobros y suscripciones. name y cpfCnpj son obligatorios. No hay campo de ciudad: Asaas toma la ciudad del postalCode.
- Actualizar clientePUTActualiza un cliente. Los campos no enviados se mantienen como están.
- Listar cobrosGETLista los cobros (cobrancas), con filtro opcional por cliente, suscripción, estado, forma de pago, fecha de pago o referencia externa. Los valores están en reales. La respuesta trae data, totalCount y hasMore; pagina con offset y limit mientras hasMore sea true.
- Consultar cobroGETDevuelve un cobro, con estado, valor, valor neto, vencimiento, fecha de pago y los enlaces invoiceUrl (la página del cobro) y bankSlipUrl (el boleto).
- Crear cobroPOSTCrea un cobro para un cliente, por boleto, Pix o tarjeta de crédito, en un pago o en cuotas. La respuesta trae invoiceUrl, la página del cobro para enviar al pagador, y Asaas puede notificar al cliente según su configuración de notificación.
- Actualizar cobroPUTActualiza un cobro aún pendiente o vencido; el cliente no se puede cambiar. Envía billingType, value y dueDate aunque no cambien, con los valores actuales de Get payment. Un nuevo valor o vencimiento puede notificar al cliente.
- Eliminar cobroDELETEElimina un cobro, que ya no se puede pagar; se puede restaurar en Asaas. No reembolsa un valor ya pagado, y eliminar un cobro de una suscripción no termina la suscripción.
- Listar suscripcionesGETLista las suscripciones, con filtro opcional por cliente, estado, forma de pago o referencia externa. Los cobros que genera una suscripción vienen de List payments con el filtro de suscripción. Pagina con offset y limit mientras hasMore sea true.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Asaas
¿Necesito implementar la API de Asaas?
No. Connect ya trae 12 tools de Asaas descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Asaas?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.

Conta Azul