API da Cielo: o que dá para fazer e como usar com agentes de IA
A Cielo oferece APIs para receber pagamentos online, como a API E-commerce Cielo, com cartão de crédito e débito, Pix, boleto e recorrência, além de link de pagamento e consulta de vendas. É usada por lojas, plataformas e áreas financeiras de quem é cliente Cielo. O acesso exige credenciamento e chaves do estabelecimento, com ambiente sandbox.
Os grandes recursos da API, em português claro.
Autorização, captura, cancelamento e consulta de pagamentos com crédito e débito.
Geração de cobranças por Pix e boleto, conforme o que está habilitado.
Cobranças periódicas programadas para assinaturas e mensalidades.
Armazenamento seguro do cartão para cobranças futuras sem guardar o número.
Criação de links para o cliente pagar sem integração de checkout.
Situação e detalhes das transações para atendimento e conciliação.
Como se acessa a API do Cielo.
- Com credencial da sua empresaMerchant ID e Merchant Key do estabelecimento, fornecidos no credenciamento; alguns produtos usam OAuth com client id e secret. Há chaves separadas para sandbox e produção.
- Nunca trafegue número de cartão em mensagens; use tokenização e link de pagamento.
- Separe chaves de sandbox e produção e restrinja quem pode estornar.
- Siga as regras de segurança de dados de cartão (PCI) e a LGPD.
- api cielo
- api cielo e-commerce
- cielo api 3.0
- cielo sandbox
- cielo api recorrência
- integração api cielo
- cielo developers
O que um agente do iTeam faz com a API do Cielo.
O agente consulta as transações do pedido, confirma se houve duplicidade ou só pré-autorização e prepara o cancelamento para aprovação.
Quando a recorrência falha, o agente avisa o cliente e envia um link de pagamento para regularizar.
Na venda consultiva, o agente gera o link com o valor aprovado pelo vendedor e acompanha até o pagamento.
O agente cruza transações capturadas com os pedidos do ERP e aponta divergências para o financeiro.
Da credencial ao agente trabalhando, com aprovação.
Obtenha as chaves e use o sandbox
Com o credenciamento, pegue as chaves do estabelecimento e valide os fluxos no ambiente de testes da Cielo.
Cadastre no cofre do iTeam
As chaves ficam no cofre; o agente de atendimento consulta transações, e só o financeiro pode pedir cancelamento.
Operações com aprovação e teto
Cancelamentos, estornos e links acima de um valor exigem aprovação humana, com teto definido.
Dúvidas sobre a API do Cielo.
A API da Cielo é gratuita?
De forma geral, o acesso à API vem com o credenciamento; a Cielo cobra taxas sobre as transações conforme o contrato do estabelecimento.
Preciso programar para usar a API da Cielo com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação e o time de implantação configura os fluxos com o seu financeiro.
Tem ambiente de testes?
Sim, a Cielo disponibiliza sandbox com chaves próprias para testar sem cobrança real.
O que um agente de IA faz com a API E-commerce da Cielo?
A API processa cartão de crédito e débito, Pix, boleto e recorrência, e há tokenização de cartão, link de pagamento e consulta de vendas. O agente consulta o status de uma venda, reenvia o link de pagamento, acompanha recorrências e prepara o caso de um estorno. Valores de saída seguem teto. No iTeam, o financeiro recebe o caso pronto.
A Cielo tem sandbox para testar transações?
Sim: a Cielo oferece um ambiente de sandbox com chaves próprias, onde você simula autorizações e recusas sem movimentar dinheiro. Há credenciais separadas para sandbox e produção. Valide ali o fluxo de venda, captura e cancelamento antes de ligar o agente. Confira na documentação como obter as credenciais de teste e quais cartões simulam cada resultado.
Como funciona a autenticação da API da Cielo com Merchant ID e Merchant Key?
Cada chamada leva o Merchant ID e a Merchant Key do estabelecimento, enviados em cabeçalhos, fornecidos no credenciamento. Alguns produtos usam OAuth com client id e secret. A Merchant Key equivale a uma senha da loja, então guarde em cofre e nunca no prompt do agente. Mantenha o par do sandbox separado do de produção.
Como o agente evita lidar com número de cartão na Cielo?
Usando tokenização de cartão e link de pagamento: o cliente digita o cartão numa página segura da Cielo e o agente recebe apenas um token ou o status. Número de cartão em chat ou no texto do agente foge das regras de segurança de dados de cartão, o PCI. Instrua o agente a recusar dados de cartão no chat e a enviar o link.
O agente pode cancelar ou estornar vendas na Cielo sozinho?
A API permite cancelar, total ou parcialmente, mas isso devolve dinheiro. Limite por valor, restrinja quem pode estornar e exija aprovação acima do teto. O agente reúne o motivo e o comprovante da venda e propõe a ação. Registre quem aprovou e o identificador do cancelamento, para a conciliação com o ERP e eventuais contestações.
A API da Cielo funciona sem ser cliente Cielo?
Não: o acesso exige credenciamento como estabelecimento, com as chaves fornecidas por ele. Quem usa outra adquirente deve integrar a API dela. Confira com a Cielo o processo de credenciamento e quais produtos, como Pix e recorrência, estão habilitados no seu contrato. Cada produto da API pode ter condições comerciais próprias.
Quanto custa usar a API da Cielo?
As condições vêm do contrato de credenciamento, com taxas por transação e por modalidade, e não há valor único para citar. A API em si faz parte do serviço de adquirência, mas confira com o seu gerente comercial se há cobrança por produto, como recorrência. Some o custo do modelo de IA do agente. O volume de vendas pesa mais.
Que dados da Cielo o agente deve proteger por LGPD?
Nome, CPF, e-mail, histórico de compras e dados de transação são pessoais. O agente usa o necessário para atender sobre aquela venda e não repete esses dados a terceiros. Restrinja o histórico a quem atende e defina retenção. Dados de cartão não passam pelo agente. Combine a política com o jurídico e com a equipe de segurança.
