API do Pagar.me: pedidos, cobranças e assinaturas com agentes de IA
O Pagar.me, da Stone, oferece uma API REST para processar pagamentos online por cartão, Pix e boleto. É usada por e-commerces, SaaS e plataformas que precisam de checkout, recorrência ou split. O acesso é por chave secreta da conta, com chaves de teste e produção.
Os grandes recursos da API, em português claro.
Cadastrar clientes e guardar cartões tokenizados.
Criar pedidos e cobranças por cartão, Pix ou boleto, capturar e estornar.
Criar recorrência, alterar planos e acompanhar faturas.
Dividir valores entre recebedores em marketplaces.
Consultar saldo e recebíveis.
Receber eventos de pagamento aprovado, recusado e estornado.
Como se acessa a API do Pagar.me.
- Com credencial da sua empresaAutenticação básica com a chave secreta da conta (sk_), com chaves distintas para teste e produção, geradas na dashboard.
- Documentação oficialdocs.pagar.me
- A chave secreta permite estornos: bloqueie essa ação no agente ou exija aprovação.
- Dados de cartão nunca passam pelo agente; use tokenização.
- Teste tudo com as chaves de teste antes de produção.
- api pagar.me
- pagar.me api documentação
- api pagarme pix
- pagarme webhook
- integração pagar.me
- pagar.me api assinatura
O que um agente do iTeam faz com a API do Pagar.me.
Quando o cartão é recusado, o agente avisa o cliente e oferece Pix ou boleto pelo canal certo.
Faturas de assinatura com falha de cobrança geram contato do agente antes do cancelamento.
O agente lista estornos e chargebacks do período com o motivo e o pedido de origem.
O agente consulta o pedido no Pagar.me e explica status e data de compensação.
Da credencial ao agente trabalhando, com aprovação.
Pegar as chaves na dashboard
Na dashboard do Pagar.me, copie a chave secreta de teste e configure o webhook que o iTeam vai receber.
Definir permissões por agente
No iTeam, a credencial do Pagar.me vai para o cofre e cada agente ganha uma lista fechada de ações (consultar pedidos, gerar Pix, ler assinaturas). Ações que alteram dados exigem aprovação de uma pessoa.
Validar em pequeno e depois ampliar
Comece por um caso: crie uma cobrança Pix com a chave de teste. Com o resultado conferido, o processo ganha mais volume, sempre com auditoria e aprovação onde houver risco.
Dúvidas sobre a API do Pagar.me.
A API do Pagar.me é gratuita?
Não há cobrança pelo uso da API; você paga as taxas por transação do contrato com o Pagar.me.
Preciso programar para usar a API do Pagar.me com o iTeam?
Não precisa. O iTeam lê a documentação da API do Pagar.me, monta as chamadas e o time de implantação ajusta o fluxo com você. O que fica com a empresa é aprovar e acompanhar.
O agente vê o número do cartão do cliente?
Não. O Pagar.me trabalha com cartões tokenizados, e o agente consulta só status, valor e dados do pedido.