API do Mercado Pago: o que dá para fazer e como usar com agentes de IA
A API do Mercado Pago permite criar cobranças, consultar pagamentos, emitir reembolsos, gerenciar assinaturas e receber notificações de mudança de status. É usada por lojas virtuais, SaaS e empresas que vendem por link, Pix ou checkout próprio. O acesso é feito com as credenciais da conta do próprio vendedor, geradas no painel de desenvolvedor.
Os grandes recursos da API, em português claro.
Criação e consulta de pagamentos com cartão, Pix e boleto, com o status de cada transação.
Geração de links e preferências de pagamento para o Checkout Pro e integrações de checkout próprio.
Devolução total ou parcial de um pagamento aprovado e cancelamento de cobranças pendentes.
Planos e cobranças recorrentes para quem vende por mensalidade.
Avisos automáticos quando um pagamento muda de status, como aprovado, recusado ou estornado.
Cadastro de compradores e cartões salvos para facilitar compras futuras.
Como se acessa a API do Mercado Pago.
- Com credencial da sua empresaA integração usa um access token da conta (com par de credenciais de teste e de produção) gerado no painel de desenvolvedor. Para operar em nome de outros vendedores, há fluxo OAuth com aplicação registrada.
- Documentação oficialwww.mercadopago.com.br/developers
- Separe credenciais de teste e de produção e nunca use a de produção em homologação.
- Reembolsos movimentam dinheiro: deixe essa ação com aprovação humana e teto por valor.
- Dados de compradores são pessoais (LGPD): limite o que o agente lê e registra.
- api mercado pago
- api do mercado pago pix
- mercado pago api documentação
- webhook mercado pago
- integração api mercado pago
- api mercado pago reembolso
- mercado pago developers
O que um agente do iTeam faz com a API do Mercado Pago.
O agente financeiro cruza os pagamentos aprovados no Mercado Pago com os pedidos do ERP e aponta divergências de valor, taxa ou pedido sem pagamento.
O agente de atendimento prepara o estorno de um pedido devolvido, mostra valor e motivo e só executa depois que o responsável aprova no WhatsApp ou no Teams.
Quando um Pix ou boleto não é pago no prazo, o agente gera um novo link e envia ao cliente, registrando cada tentativa.
O agente acompanha as notificações de status e avisa o time quando a taxa de recusa sobe ou surge uma contestação.
Da credencial ao agente trabalhando, com aprovação.
Gerar as credenciais
No painel de desenvolvedor do Mercado Pago, crie uma aplicação e copie as credenciais de teste e de produção da conta da empresa.
Guardar no cofre do iTeam
Cadastre o token no cofre do iTeam e defina o que cada agente pode fazer: consultar pagamentos, gerar links ou pedir reembolsos.
Testar com aprovação humana
Rode primeiro com as credenciais de teste e mantenha reembolsos e cobranças sob aprovação até o processo estar validado.
Dúvidas sobre a API do Mercado Pago.
A API do Mercado Pago é gratuita?
O uso da API em si não costuma ter cobrança separada; o que se paga são as tarifas sobre cada transação, conforme o meio de pagamento e o plano da conta.
Preciso programar para usar a API do Mercado Pago com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação oficial e o time de implantação configura as chamadas; você só fornece a credencial e as regras de aprovação.
O agente consegue criar link de pagamento sozinho?
Consegue, se você der essa permissão. O mais comum é liberar a geração de links e deixar estornos e cancelamentos com aprovação.
O que um agente de IA consegue fazer com a API do Mercado Pago?
Com as credenciais da conta, o agente cria cobranças, consulta o status de um pagamento, acompanha assinaturas e emite reembolsos dentro de uma regra. A API também avisa mudanças por webhook, e o agente reage ao pagamento aprovado liberando o pedido. Valores de saída ficam com teto e aprovação humana. No iTeam o agente financeiro tem cargo com permissões separadas para ler e para devolver.
Como testar a API do Mercado Pago sem cobrar clientes reais?
O Mercado Pago separa credenciais de teste e de produção, e o desenvolvedor pode usar contas e cartões de teste para simular aprovação e recusa. Você faz o fluxo inteiro com o access token de teste e só troca para o de produção no fim. Nunca misture os dois: a chave de produção em ambiente de homologação cria cobrança verdadeira.
Como o access token do Mercado Pago é obtido e protegido?
Ele nasce no painel de desenvolvedor, na aplicação criada na conta, junto com a chave pública e os pares de teste e produção. O access token autoriza cobrança e reembolso, então guarde em cofre e nunca no prompt do agente. Para operar em nome de outros vendedores, o caminho é o OAuth com aplicação registrada, em que cada vendedor autoriza por conta própria.
Como o agente sabe que um pagamento Pix ou cartão foi aprovado no Mercado Pago?
Pela notificação de webhook, que informa a mudança de status e leva o identificador do pagamento; o agente então consulta a API para confirmar o estado real. Confiar só no corpo do aviso é arriscado, por isso a confirmação por consulta. Com o status aprovado, ele libera o pedido; com pendente, aguarda; com recusado, avisa o cliente com uma nova opção.
O agente pode criar link de pagamento do Mercado Pago sozinho?
Pode, porque a API cria preferências de checkout com itens e valor e devolve um link. O ponto de controle é o valor: o agente cria links dentro de um limite definido e acima dele pede aprovação. Também convém restringir quem pode pedir o link, para ninguém gerar cobrança de outro cliente. O registro mostra quem solicitou e qual conta recebeu.
A API do Mercado Pago permite reembolso automático e como limitar o risco?
Permite: existe recurso de reembolso total ou parcial por pagamento. Como movimenta dinheiro, o agente deve operar com teto por valor, só em pedido identificado e com motivo registrado, e passar o resto para uma pessoa. Defina também uma lista de motivos aceitos, como produto em falta, para que a regra seja objetiva e fácil de auditar depois.
Preciso programar para integrar o Mercado Pago a um agente de IA?
Para o caso comum, pouco: criar a aplicação, copiar as credenciais e apontar o webhook para a URL do agente. A programação aparece se o seu checkout é próprio ou se você quer lógica de conciliação com o ERP. O Mercado Pago tem bibliotecas oficiais para várias linguagens, o que reduz o esforço, e o teste com credenciais de teste mostra rápido o que falta.
Os dados de compradores do Mercado Pago podem ser lidos livremente pelo agente?
Não devem: CPF, e-mail e dados de pagamento são pessoais e o agente precisa de acesso mínimo à finalidade, como confirmar um pedido. Evite que o agente repita esses dados em canais abertos e restrinja o histórico a quem atende. Dados de cartão nunca passam pelo agente; o Mercado Pago tokeniza isso no checkout. Defina retenção com o jurídico, conforme a LGPD.
