Mercado Pago: OAuth, PIX e o token de 6 meses

Como na Stripe, você não cola credencial nenhuma no MMNWEB. Você autoriza a aplicação da Fragasoft a cobrar na sua conta, e o Mercado Pago devolve um token ao nosso servidor. Mas o MP tem uma particularidade que já derrubou o split de muita gente — e ela está no fim desta página.

Os tipos de credencial do Mercado Pago

Cada par é único por aplicação (vinculado à aplicação criada, não a uma conta genérica). E há dois conjuntos: teste e produção. As de teste já vêm ativas; as de produção precisam ser ativadas, preenchendo os dados do negócio (incluindo o ramo).

Quem tem o quê, no MMNWEB

A Fragasoft mantém a aplicação de plataforma no Mercado Pago e guarda Client ID, Client Secret e o segredo de webhook — credenciais globais, cifradas em repouso, que nunca vão pro navegador nem pro repositório. Você mantém a sua conta Mercado Pago e não nos entrega Public Key nem Access Token manualmente. Ao autorizar, o MP entrega ao nosso servidor um conjunto ligado a você: access_token, refresh_token, user_id (o seu ID de recebedor) e public_key — armazenados cifrados (AES-256-GCM) e usados só para cobrar em seu nome.

Como conectar, passo a passo

1. No painel do MMNWEB, vá até a configuração de pagamentos do seu projeto.
2. Clique em "Conectar minha conta Mercado Pago".
3. Você é levado ao Mercado Pago. Faça login na sua conta e autorize a aplicação.
4. O MP redireciona de volta e o MMNWEB grava a autorização.
5. Confira o status: o PIX só aparece no checkout quando estiver pronto.

⚠️ A armadilha: o token do vendedor expira em 6 meses

O access_token que o MP emite para o vendedor tem validade de 180 dias (o campo expires_in retorna 15.552.000 segundos). Junto dele vem um refresh_token, feito exatamente para renovar o acesso antes do vencimento. Se o token vencer sem renovação, o split daquele lojista simplesmente para — não é uma falha ruidosa; é uma cobrança que deixa de ser autorizada.

O MMNWEB renova automaticamente antes do vencimento — você não precisa fazer nada. Mas precisa saber que isso existe, por dois motivos:

Como funciona o split

A cobrança PIX acontece dentro do MMNWEB, na sua conta Mercado Pago. A taxa da plataforma é descontada via application_fee — o mecanismo nativo de split do MP. O dinheiro não passa pela conta da Fragasoft: usar o split nativo é o que mantém a operação fora das exigências regulatórias de quem custodia recurso de terceiro. O percentual é definido pela Fragasoft e configurado no sistema — você não o edita. Como na Stripe, vale a regra "sem provedor pronto, sem venda": o checkout só oferece o PIX quando a autorização está válida e a capacidade de cobrar foi verificada de verdade.

Perguntas rápidas

Preciso mandar meu Access Token pro suporte? Não. O fluxo é OAuth; o token chega direto ao servidor. Se alguém pedir seu Access Token por mensagem, desconfie.

O PIX parou do nada. Duas causas prováveis: autorização revogada no painel do MP, ou credenciais de produção renovadas manualmente. Abra um chamado antes de mexer.

Testei com credenciais de teste e funcionou. Teste e produção são conjuntos distintos. Produção precisa ser ativada no painel, com os dados do negócio preenchidos.

Uso Mercado Pago e Stripe ao mesmo tempo? Sim. Em geral: PIX pelo Mercado Pago, cartão pela Stripe.

Fontes oficiais

Credenciais (tipos, teste × produção) · OAuth — Access Token, validade e refresh · Referência da API OAuth

Relacionados: Visão geral das integrações · Stripe (cartão) · Cielo · Conceitos do motor