API do PagSeguro (PagBank): o que dá para fazer e como usar com agentes de IA
A API do PagSeguro, hoje sob a marca PagBank, permite criar cobranças, consultar transações e receber notificações de pagamento. É usada por lojas virtuais, prestadores de serviço e plataformas que vendem online. O acesso é feito com token da conta, com ambiente de testes disponível.
Os grandes recursos da API, em português claro.
Criação de pedidos com cartão, boleto ou Pix e acompanhamento do status do pagamento.
Geração de links e checkouts para enviar ao cliente.
Busca de pagamentos realizados e seus detalhes.
Cancelamento de cobranças e devolução de valores.
Avisos ao sistema da empresa quando o status de um pagamento muda.
Como se acessa a API do PagSeguro.
- Com credencial da sua empresaUsa token de autenticação gerado na conta PagBank, com tokens distintos para o ambiente de testes (sandbox) e de produção.
- Sandbox e produção usam credenciais diferentes; não misture os dois.
- Nunca trafegue número de cartão pelo agente: use checkout ou link de pagamento.
- Estornos e cancelamentos devem ter teto de valor e aprovação.
- api pagseguro
- api pagbank
- pagseguro api documentação
- integração api pagseguro
- pagseguro api sandbox
- notificação pagseguro api
- api pagseguro pix
O que um agente do iTeam faz com a API do PagSeguro.
Durante o atendimento, o agente gera o link de pagamento com o valor do pedido e envia ao cliente, avisando o vendedor quando for pago.
O agente encontra pagamentos pendentes ou recusados e aborda o cliente com uma alternativa, como Pix ou novo cartão.
Transações do dia são comparadas aos pedidos do e-commerce e do ERP, e divergências vão para o financeiro.
Solicitações de estorno são preparadas pelo agente com o histórico do pedido e executadas só depois da aprovação.
Da credencial ao agente trabalhando, com aprovação.
Gere o token no PagBank
Na conta PagBank, gere o token de integração, começando pelo de sandbox para testes.
Cadastre no cofre do iTeam
O token fica no cofre; você define quem cria cobranças, quem consulta e que estornos exigem aprovação.
Teste no sandbox e vá para produção
O agente roda os fluxos no sandbox, a notificação é validada e só então o token de produção é cadastrado.
Dúvidas sobre a API do PagSeguro.
A API do PagSeguro é gratuita?
Usar a API não costuma ter cobrança à parte; o custo vem das tarifas por transação do PagBank, que dependem do plano e do meio de pagamento.
Preciso programar para usar a API do PagSeguro com o iTeam?
Não necessariamente. O iTeam lê a documentação do PagBank e o time de implantação configura cobranças, consultas e notificações com você.
O PagSeguro tem ambiente de testes?
Sim, há sandbox para testar cobranças sem movimentar dinheiro real.
O que um agente de IA faz com a API do PagSeguro, hoje PagBank?
A API do PagBank cria pedidos e cobranças, gera links de pagamento, consulta transações e recebe notificações. O agente acompanha o status do pedido, reenvia o link para quem não pagou e avisa o time sobre estornos. Valores de saída seguem teto. No iTeam, o agente financeiro cruza os pagamentos com o ERP e responde ao cliente no WhatsApp.
O PagSeguro tem sandbox para testar pagamentos?
Sim: há um ambiente de testes com credenciais próprias e endereço diferente do de produção, onde você simula cobranças e notificações. O token de sandbox é distinto do de produção, e misturar os dois gera cobrança real ou erro de autenticação. Valide o fluxo completo ali, incluindo o recebimento da notificação, antes de ligar o agente.
Como autenticar na API do PagBank e proteger o token?
O token de autenticação é gerado na conta PagBank e enviado no cabeçalho de autorização das chamadas. O token de produção autoriza cobrança e estorno, então fica em cofre e não no prompt do agente. Se houver suspeita de vazamento, gere outro e revogue o anterior. Mantenha tokens separados para teste e produção, identificados por nome.
O agente pode receber dados de cartão para cobrar pelo PagSeguro?
Não deve: número de cartão nunca trafega pelo agente nem pelo chat. Use o checkout do PagBank ou o link de pagamento, em que o cliente digita o cartão numa página própria da instituição. O agente trabalha só com o identificador da cobrança e o status. Isso também reduz o escopo das exigências de segurança de dados de cartão.
Como o agente sabe que um pagamento no PagSeguro mudou de status?
Pela notificação, que a API envia ao endereço que você informou ao criar o pedido; o agente então consulta a transação para confirmar o estado. Se o aviso falhar, uma consulta periódica das cobranças pendentes pega o que escapou. Defina o que fazer em cada status: liberar, aguardar ou avisar o cliente de um pagamento recusado.
O agente pode fazer estorno ou cancelamento no PagSeguro sozinho?
A API permite, mas é saída de dinheiro: coloque um teto por valor e aprovação humana acima dele. O agente pode abrir o pedido de estorno com o motivo e os dados do pagamento, e uma pessoa do financeiro confirma. Registre o identificador da transação e quem aprovou. Isso evita estornos indevidos e facilita a conciliação.
Quanto custa a API do PagSeguro?
A documentação não cobra pela API em si; as tarifas são as da conta PagBank, por meio de pagamento, e variam com o plano e o volume. Confira a tabela vigente no site. Para o agente, soma-se o custo do modelo de IA. O que mais pesa é o volume de transações e o meio escolhido, como cartão, Pix ou boleto.
Preciso de programador para ligar o PagSeguro a um agente?
Para gerar o token, cadastrar a URL de notificação e testar no sandbox, ajuda ter alguém técnico na primeira vez. Depois, o agente roda com as regras que você definir. Se o seu checkout é próprio, a integração do pedido exige desenvolvimento. Se você já usa link de pagamento, o esforço é bem menor.
