[ajuda] conexões

Mercado Pago do zero: conta, aplicação, Access Token e vendas nas Finanças

Crie uma aplicação no painel de desenvolvedor do Mercado Pago, ative o ambiente de Produção e copie o Access Token de produção. Cole no AFK, na Central de Conexões, no cartão Mercado Pago — vendas nas Finanças. A partir daí, cada venda aprovada vira receita nas Finanças, com a taxa que o Mercado Pago cobrou. Ler as vendas pela API não custa nada. O Mercado Pago não tem chave só de leitura: esse token abre a conta inteira, então guarde como a senha do banco.

Isso faz parte do AFK, o Claude que você assina já configurado no seu computador. Conhecer o AFK

Para que serve no AFK

Venda entra sozinha nas Finanças. Cada pagamento aprovado (Pix, cartão, boleto, link) vira receita pelo valor cheio. A taxa do Mercado Pago entra como despesa da categoria taxa. Você para de lançar à mão.
Estorno e contestação descontam sozinhos. Estorno total ou parcial e contestação encerrada contra você, até 180 dias depois da venda, entram como despesa da categoria estorno. Contestação aberta aparece no resumo do dia.
Link de pagamento na cobrança vencida. Cada cobrança vencida ganha um link do Mercado Pago (cartão ou Pix). O link entra na mensagem de cobrança pronta e no orçamento. Quando o cliente paga, o AFK dá baixa naquela cobrança sozinho.
Quando ele lê: a rotina da manhã traz os últimos 7 dias. Em Finanças → Vendas automáticas, o botão Importar vendas agora traz os últimos 30 dias na hora.

O que o AFK não faz com o token: não estorna, não transfere, não mexe no saldo e não manda nada para o cliente. Você decide quando enviar a cobrança.

Só entra venda em real. Pagamento em outra moeda fica de fora, e o AFK avisa.

Antes: quanto custa

A API do Mercado Pago é grátis. O AFK só lê as vendas e cria links. Você paga ao Mercado Pago a tarifa normal de cada venda, como já paga hoje. Não há valor fixo por mês.

Tarifas do Link de pagamento, na página oficial, conferidas em 30/10/2026:

Meio de pagamento	Quando o dinheiro fica livre	Tarifa
Pix	Na hora	0,99%
Cartão de crédito	Na hora	4,98%
Cartão de crédito	Em 14 dias	4,48%
Cartão de crédito	Em 30 dias	3,99%
Boleto	Em até 3 dias	3,99%

Algumas contas novas não têm a opção "na hora" e recebem em 7 dias no começo. O parcelamento tem tarifa à parte. As tarifas mudam: confira em mercadopago.com.br/ferramentas-para-vender/link-de-pagamento. A tarifa que vale é a que aparece em cada venda na sua conta, e é essa que o AFK lança.

Parte 1: conta e segurança

Use a conta do Mercado Pago que recebe as vendas. Se ainda não tem, baixe o app do Mercado Pago e crie a conta.
Ligue a verificação em duas etapas. No app, toque na sua foto no topo → Segurança → Verificação em duas etapas. Prefira o aplicativo autenticador: ele não depende de sinal de celular.
Nunca passe o código que chega por SMS ou WhatsApp para ninguém, nem para quem diz ser do suporte.

Parte 2: criar a aplicação e ativar a produção

O token sai de uma "aplicação", um cadastro que liga um programa à sua conta. Você cria uma só vez.

No computador, entre em mercadopago.com.br/developers/panel/app com a mesma conta que recebe as vendas.
Crie uma aplicação. Use um nome fácil de reconhecer, por exemplo AFK. Se o formulário perguntar o produto, escolha Checkout Pro: é o tipo de link de pagamento que o AFK cria.
A aplicação aparece como um cartão em Integrações. Clique nele.
No menu lateral, clique em Credenciais.
No seletor de ambiente, no topo da tela, escolha Produção e clique em Ativar ambiente de produção.
Preencha o setor de atuação e o site do negócio.
Aceite a Declaração de Privacidade e os Termos e condições e clique em Ativar.

Parte 3: copiar o Access Token e colar no AFK

Ainda em Credenciais, confira que o seletor no topo está em Produção. Isso é o mais importante desta página. O token de teste também começa com APP_USR-, então pelo começo não dá para saber qual é qual.
Copie o Access Token. Ele começa com APP_USR- e é bem comprido. Não copie a Public Key, o Client ID nem o Client Secret.
No painel do AFK, abra Conexões, clique no cartão Mercado Pago — vendas nas Finanças, cole em Access Token de produção, clique em Salvar conexão e depois em Testar.
Abra Finanças → Vendas automáticas e clique em Importar vendas agora. As vendas dos últimos 30 dias entram como receita.

Teste ou produção. As credenciais de teste servem para quem está programando: nenhum pagamento é de verdade. Com o token de teste, o Testar passa, mas nenhuma venda real aparece. Para o AFK, use sempre o de produção.

Onde o token fica. Só no arquivo .env da pasta do AFK, no seu computador. Ele não vai para a nuvem do AFK, não sobe para o GitHub e não aparece na conversa. Nunca cole o token no chat, no WhatsApp ou em print.

No dia a dia

Você quer	Como
Trazer as vendas agora	Finanças → Vendas automáticas → Importar vendas agora. Ou diga ao AFK "importa minhas vendas".
Ver as vendas por canal	Finanças → Vendas por canal: vendido, devolvido, taxas e líquido do Mercado Pago.
Cobrar um cliente atrasado	A cobrança vencida já vem com o link. O painel abre o WhatsApp com a mensagem pronta e você decide se envia.
Mandar orçamento com link	O orçamento sai com Pague online (cartão ou Pix). Pagou, o pedido fica confirmado sozinho.
Avisar que já devolveu um valor	Diga ao AFK "já devolvi o dinheiro do Caio" ou "pode tirar esse da lista de devolver".
Lançar venda feita fora do Mercado Pago	Lance à mão. Venda do Mercado Pago, não: ela entraria duas vezes.
Trocar o token	Cole o novo no mesmo cartão, por cima, e clique em Salvar conexão e Testar.
Desligar a conexão	No cartão, clique em Desconectar e confirme. O AFK apaga o token do `.env`.

Se o token vazar (print, mensagem, arquivo enviado): entre na aplicação → Credenciais → Produção e renove o Access Token pelo menu ao lado dele. O Mercado Pago gera um par novo (Public Key e Access Token), e o que usava o par antigo para de funcionar. Cole o Access Token novo no AFK na hora. Se viu movimentação que não reconhece, troque também a senha da conta e fale com o suporte do Mercado Pago.

Erros e soluções

O que aparece	O que fazer
`O serviço recusou a chave (inválida, revogada ou sem permissão).` no Testar	O token foi renovado, está incompleto ou é de outra conta. Copie de novo o Access Token de Produção e cole por cima.
`Access Token de produção: o formato não parece o esperado.`	Você copiou outro campo (Public Key, Client Secret) ou faltou um pedaço. O certo começa com `APP_USR-`.
`unauthorized_use_of_live_credentials`	O ambiente de produção não foi ativado. Faça a Parte 2, passos 4 a 7.
Testar passa, mas nenhuma venda entra	O token é de teste, ou é de outra conta. Confira o seletor em Produção e se a aplicação está na conta que recebe as vendas.
`Não consegui ler: Mercado Pago — confira a chave em Conexões.`	O Mercado Pago recusou a leitura. Clique em Testar no cartão para ver o motivo.
`outra leitura de vendas está em andamento; tente de novo em 1 minuto`	A rotina da manhã está lendo junto. Espere um minuto e clique de novo.
`Mercado Pago: N venda(s) com a taxa ainda não lida`	O Mercado Pago ainda não calculou a taxa. O AFK busca de novo nas próximas leituras, por até 30 dias.
`Ficaram de fora: 1 moeda USD`	Venda em outra moeda. O AFK só lança venda em real. Lance à mão, convertida.
A cobrança vencida saiu sem o link	Sem token, ou o Mercado Pago não respondeu. A cobrança sai só com o Pix. Clique em Testar no cartão.

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande o token.

Fontes oficiais (conferido em 30/10/2026): mercadopago.com.br/developers/pt/docs/your-integrations/credentials (credenciais de teste e de produção; seletor Teste/Produção; Ativar ambiente de produção com setor, site e termos; o Access Token é privado e não vai no front) · mercadopago.com.br/developers/pt/docs/checkout-pro/create-application (painel em /developers/panel/app; o token de teste começa com APP_USR, o mesmo prefixo do de produção) · mercadopago.com.br/developers/pt/docs/checkout-pro/resources/credentials (renovar as credenciais de produção por segurança gera um par novo e afeta a integração até a troca) · mercadopago.com.br/developers/pt/docs/vtex/additional-content/possible-errors (unauthorized_use_of_live_credentials = credenciais de produção não ativadas) · mercadopago.com.br/ferramentas-para-vender/link-de-pagamento (tarifas: Pix 0,99%, crédito 4,98% / 4,48% / 3,99%, boleto 3,99%; sem valor fixo por mês) · mercadopago.com.br/blog/ativar-verificacao-duas-etapas-mercado-pago (foto do perfil → Segurança → Verificação em duas etapas; SMS, e-mail ou app autenticador).

trilha Receber e controlar as vendas · passo 1 de 5

próximoStripe do zero: chave restrita só de leitura e vendas nas Finanças

ainda não tem o AFK?

Com o Mercado Pago ligado, cada venda aprovada entra sozinha nas Finanças do AFK, com a taxa, e a cobrança vencida ganha um link de pagamento.

O AFK deixa o Claude que você assina configurado e atualizado no seu computador: painel do negócio, conteúdo, documentos, travas e antivírus prontos. Você fala, o sistema opera. 7 dias de garantia.

Conhecer o AFK

Chaves e conexões

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.