API de Pix: qué se puede hacer y cómo usarla con agentes de IA
Pix es el sistema de pagos instantáneos de Brasil, y su API es la especificación definida por el Banco Central de Brasil para que los bancos y las entidades de pago ofrezcan cobros y consultas de Pix de forma programática. La usan empresas que cobran en Brasil y quieren generar cobros con código QR y conciliar los ingresos automáticamente. El acceso es siempre a través del banco o del proveedor de pagos de la empresa, con las credenciales y el certificado de la cuenta.
Qué ofrece la API de Pix
Cobro inmediato
Creación de cobros con importe e identificador, que generan un código QR y un código para copiar y pegar.
Cobro con vencimiento
Cobros con fecha de vencimiento, intereses, multa y descuento, al estilo del boleto.
Consulta de Pix recibidos
Listado y consulta de los Pix que han entrado en la cuenta, con el identificador de la transacción.
Devoluciones
Solicitud de devolución total o parcial de un Pix recibido.
Webhooks
Notificación al sistema de la empresa cuando se recibe un Pix en la clave registrada.
Locations de payload
Gestión de las direcciones que se usan para los códigos QR dinámicos.
Cómo acceder a la API de Pix
- Con las credenciales de tu empresaCada banco o proveedor de pagos define el acceso, pero lo habitual es OAuth 2.0 con client credentials y un certificado digital (mTLS) emitido para la cuenta de la empresa.
- El certificado y las credenciales dan acceso a la cuenta: restringe quién puede gestionarlos y renuévalos antes de que venzan.
- Cada banco tiene límites de solicitudes y particularidades más allá del estándar del Banco Central.
- Los movimientos de salida deben tener siempre aprobación humana y un tope de importe.
Documentación oficial: bacen.github.io/pix-api
Qué hace un agente de iTeam con la API de Pix
Cobro por WhatsApp con baja automática
El agente genera el cobro Pix, envía al cliente el código para copiar y pegar y, cuando el webhook confirma el pago, da de baja el título en el ERP y da las gracias.
Conciliación diaria
El agente cruza los Pix recibidos con los títulos abiertos y lista los pagos sin identificar para finanzas.
Devolución con aprobación
Las solicitudes de reembolso llegan al agente, que comprueba el pago y prepara la devolución; la ejecución solo ocurre tras la aprobación de un responsable.
Cobro de vencidos
Para los títulos atrasados, el agente genera un Pix con vencimiento, ya con los intereses y la multa de la política, y lo sigue hasta el pago.
De la credencial al agente trabajando, con aprobación
Habilita la API en tu banco
Solicita al banco o al proveedor de pagos el acceso a la API de Pix, genera el client ID, el secret y el certificado de la aplicación, y registra la clave Pix que recibirá los cobros.
Guarda credenciales y certificado en la bóveda
iTeam almacena las credenciales y el certificado en la bóveda; la lectura y la generación de cobros pueden ser automáticas, mientras que las devoluciones exigen aprobación.
Prueba en homologación
Usa el entorno de homologación del banco, cuando exista, valida el webhook y solo entonces pasa a producción con un tope de importe por operación.
Equipos de IA listos para este trabajo
Conciliación bancaria
Darwin cruza cada movimiento del extracto con su factura o cobro, y a tu equipo le llega solo lo que no cuadra, con el motivo.
Cuentas por pagar
Darwin lee cada factura que llega a Gmail, la registra y la deja lista para pagar; tú solo apruebas.
Cobranza y cuentas por cobrar
Darwin sabe quién debe y desde cuándo, Jaca escribe con tacto por WhatsApp o correo y Henry cuida que cada mensaje sea correcto.
Flujo de caja
Darwin rehace la proyección de caja cada semana con lo que de verdad entró y salió, y te avisa con tiempo si viene una semana en rojo.
Contabilidad del día a día
Darwin clasifica cada documento y propone el asiento, Nina persigue lo que falta y el contador dedica su tiempo a revisar y asesorar.
Preguntas sobre la API de Pix
¿La API de Pix es gratuita?
Depende del banco o del proveedor de pagos. La especificación es pública, pero las tarifas por cobro o recepción y el posible coste de acceso se definen en el contrato con la entidad.
¿Necesito programar para usar la API de Pix con iTeam?
No necesariamente. iTeam lee la documentación de la API de Pix de tu banco y el equipo de implantación configura las rutinas; tu equipo se ocupa de la habilitación ante el banco.
¿Funciona con cualquier banco?
Funciona con las entidades que ofrecen la API de Pix a las empresas. Las diferencias entre bancos se resuelven en la configuración.
