API de Pagar.me: pedidos, cobros y suscripciones con agentes de IA
Pagar.me, de Stone, es una pasarela brasileña que ofrece una API REST para procesar pagos online con tarjeta, Pix y boleto (el boleto es un cobro bancario brasileño y Pix, el pago instantáneo). La usan tiendas online, empresas SaaS y plataformas que necesitan checkout, cobros recurrentes o split. El acceso se hace con la clave secreta de la cuenta, con claves de prueba y de producción.
Qué ofrece la API de Pagar.me
Clientes y tarjetas
Registrar clientes y guardar tarjetas tokenizadas.
Pedidos y cobros
Crear pedidos y cobros con tarjeta, Pix o boleto, capturar y reembolsar.
Suscripciones y planes
Crear cobros recurrentes, cambiar planes y seguir las facturas.
Receptores y split
Dividir importes entre receptores en marketplaces.
Saldo y transferencias
Consultar el saldo y los cobros por recibir.
Webhooks
Recibir eventos de pago aprobado, rechazado y reembolsado.
Cómo acceder a la API de Pagar.me
- Con las credenciales de tu empresaAutenticación básica con la clave secreta de la cuenta (sk_), con claves distintas para pruebas y producción, generadas en el panel.
- La clave secreta permite reembolsos: bloquea esa acción en el agente o exige aprobación.
- Los datos de tarjeta nunca pasan por el agente; usa tokenización.
- Prueba todo con las claves de prueba antes de pasar a producción.
Documentación oficial: docs.pagar.me
Qué hace un agente de iTeam con la API de Pagar.me
Recuperación de un pago rechazado
Cuando se rechaza la tarjeta, el agente avisa al cliente y le ofrece Pix o boleto por el canal adecuado.
Suscripción en riesgo
Las facturas de suscripción con fallo de cobro generan un contacto del agente antes de la cancelación.
Revisión de reembolsos
El agente lista los reembolsos y contracargos del período con el motivo y el pedido de origen.
Consulta del cliente sobre un cobro
El agente consulta el pedido en Pagar.me y explica el estado y la fecha de acreditación.
De la credencial al agente trabajando, con aprobación
Obtener las claves en el panel
En el panel de Pagar.me, copia la clave secreta de prueba y configura el webhook que recibirá iTeam.
Definir permisos por agente
En iTeam, la credencial de Pagar.me se guarda en la bóveda y cada agente recibe una lista cerrada de acciones (consultar pedidos, generar un Pix, leer suscripciones). Las acciones que modifican datos requieren la aprobación de una persona.
Validar en pequeño y luego ampliar
Empieza por un caso: crea un cobro con Pix usando la clave de prueba. Con el resultado verificado, el proceso gana volumen, siempre con auditoría y aprobación donde haya riesgo.
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 Pagar.me
¿La API de Pagar.me es gratuita?
No se cobra por usar la API; pagas las comisiones por transacción de tu contrato con Pagar.me.
¿Necesito programar para usar la API de Pagar.me con iTeam?
No. iTeam lee la documentación de la API de Pagar.me, arma las llamadas y el equipo de implantación ajusta el flujo contigo. A la empresa le queda aprobar y supervisar.
¿El agente ve el número de tarjeta del cliente?
No. Pagar.me trabaja con tarjetas tokenizadas, y el agente consulta solo el estado, el importe y los datos del pedido.
