API de Cielo: qué puedes hacer y cómo usarla con agentes de IA
Cielo es un procesador de pagos brasileño. Ofrece APIs para recibir pagos online, como la API E-commerce Cielo, con tarjeta de crédito y débito, Pix, boleto y recurrencia, además de enlace de pago y consulta de ventas. La usan tiendas, plataformas y áreas financieras de clientes de Cielo. El acceso exige un alta como comercio y las claves del establecimiento, con un entorno sandbox.
Qué ofrece la API de Cielo
Transacciones con tarjeta
Autorización, captura, cancelación y consulta de pagos con crédito y débito.
Pix y boleto
Generación de cobros por Pix, el pago instantáneo de Brasil, y por boleto, según lo que esté habilitado.
Recurrencia
Cobros periódicos programados para suscripciones y cuotas mensuales.
Tokenización de tarjetas
Almacenamiento seguro de la tarjeta para cobros futuros sin guardar el número.
Enlace de pago
Creación de enlaces para que el cliente pague sin integrar un checkout.
Consulta de ventas
Estado y detalle de las transacciones para atención y conciliación.
Cómo acceder a la API de Cielo
- Con las credenciales de tu empresaMerchant ID y Merchant Key del establecimiento, entregados en el alta; algunos productos usan OAuth con client id y secret. Hay claves separadas para sandbox y producción.
- No hagas circular nunca un número de tarjeta en mensajes; usa tokenización y enlace de pago.
- Separa las claves de sandbox y de producción y restringe quién puede devolver pagos.
- Sigue las reglas de seguridad de datos de tarjetas (PCI) y la LGPD, la ley de protección de datos de Brasil.
Qué hace un agente de iTeam con la API de Cielo
Cliente que dice que le cobraron dos veces
El agente consulta las transacciones del pedido, confirma si hubo duplicidad o solo una preautorización y prepara la cancelación para su aprobación.
Suscripción con tarjeta rechazada
Cuando falla la recurrencia, el agente avisa al cliente y le envía un enlace de pago para regularizar.
Enlace de pago por WhatsApp
En la venta consultiva, el agente genera el enlace con el importe aprobado por el vendedor y lo sigue hasta el pago.
Revisión de las ventas del día
El agente cruza las transacciones capturadas con los pedidos del ERP y señala las diferencias a finanzas.
De la credencial al agente trabajando, con aprobación
Obtén las claves y usa el sandbox
Con el alta como comercio, toma las claves del establecimiento y valida los flujos en el entorno de pruebas de Cielo.
Regístralas en la bóveda de iTeam
Las claves quedan en la bóveda; el agente de atención consulta transacciones y solo finanzas puede pedir una cancelación.
Operaciones con aprobación y tope
Las cancelaciones, las devoluciones y los enlaces por encima de un importe exigen aprobación humana, con un tope definido.
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 Cielo
¿La API de Cielo es gratuita?
En general, el acceso a la API viene con el alta como comercio; Cielo cobra comisiones sobre las transacciones según el contrato del establecimiento.
¿Necesito programar para usar la API de Cielo con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación y el equipo de implantación configura los flujos con tu área de finanzas.
¿Hay un entorno de pruebas?
Sí, Cielo ofrece un sandbox con claves propias para probar sin cobros reales.
