API de PagSeguro (PagBank): qué puedes hacer y cómo usarla con agentes de IA
La API de PagSeguro, hoy bajo la marca PagBank, permite crear cobros, consultar transacciones y recibir notificaciones de pago. PagSeguro es una empresa brasileña de pagos, así que esta guía es para negocios que venden en Brasil. La usan tiendas online, prestadores de servicios y plataformas que venden por internet. El acceso se hace con el token de la cuenta, y hay un entorno de pruebas disponible.
Qué ofrece la API de PagSeguro
Pedidos y cobros
Creación de pedidos con tarjeta, boleto o Pix y seguimiento del estado del pago. El boleto y el Pix son medios de pago típicos de Brasil.
Enlaces de pago
Generación de enlaces y checkouts para enviar al cliente.
Consulta de transacciones
Búsqueda de los pagos realizados y sus detalles.
Reembolsos y cancelaciones
Cancelación de cobros y devolución de importes.
Notificaciones
Avisos al sistema de la empresa cuando cambia el estado de un pago.
Cómo acceder a la API de PagSeguro
- Con las credenciales de tu empresaUsa un token de autenticación generado en la cuenta de PagBank, con tokens distintos para el entorno de pruebas (sandbox) y para producción.
- Sandbox y producción usan credenciales distintas: no las mezcles.
- Nunca hagas pasar números de tarjeta por el agente: usa checkout o enlace de pago.
- Los reembolsos y las cancelaciones deben tener un tope de importe y aprobación.
Qué hace un agente de iTeam con la API de PagSeguro
Enlace de pago dentro de la conversación
Durante la atención, el agente genera el enlace de pago con el importe del pedido y se lo envía al cliente. Cuando se paga, avisa al vendedor.
Pedidos atascados
El agente encuentra pagos pendientes o rechazados y contacta al cliente con una alternativa, como Pix o una tarjeta nueva.
Conciliación de ventas
Las transacciones del día se comparan con los pedidos del e-commerce y del ERP, y las diferencias van a finanzas.
Reembolso con aprobación
El agente prepara las solicitudes de reembolso con el historial del pedido y solo se ejecutan después de la aprobación.
De la credencial al agente trabajando, con aprobación
Genera el token en PagBank
En la cuenta de PagBank, genera el token de integración, empezando por el de sandbox para las pruebas.
Regístralo en la bóveda de iTeam
El token queda en la bóveda. Tú defines quién crea cobros, quién consulta y qué reembolsos requieren aprobación.
Prueba en sandbox y pasa a producción
El agente ejecuta los flujos en sandbox, se valida la notificación y solo entonces se registra el token de producció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 PagSeguro
¿La API de PagSeguro es gratuita?
Usar la API normalmente no tiene un cobro aparte. El costo viene de las tarifas por transacción de PagBank, que dependen del plan y del medio de pago.
¿Necesito programar para usar la API de PagSeguro con iTeam?
No necesariamente. iTeam lee la documentación de PagBank y el equipo de implantación configura contigo los cobros, las consultas y las notificaciones.
¿PagSeguro tiene entorno de pruebas?
Sí, hay un sandbox para probar cobros sin mover dinero real.
