Credenciais

As credenciais são chaves de acesso exclusivas com as quais identificamos uma integração em sua conta. Elas estão diretamente vinculadas à aplicação criada para essa integração e permitem autenticar com segurança as operações com o Mercado Pago.

Tipos de credenciais

As credenciais são divididas em credenciais de teste e credenciais de produção. Utilize as credenciais do ambiente em que estiver trabalhando e substitua-as somente quando passar de teste para produção.

Credenciais de teste

Credenciais de produção

Credenciais de teste

As credenciais de teste permitem configurar e validar a integração sem processar operações reais. Elas são criadas automaticamente junto com a aplicação.

Para consultá-las, siga estas etapas:

1. Acesse Integrações e selecione a aplicação.
2. Selecione Teste no seletor de ambiente localizado na parte superior da tela.
3. Acesse as credenciais por uma das seguintes opções:
   • Em Início, localize o bloco Credenciais.
   • No menu lateral, selecione Credenciais.

Em ambos os casos, você encontrará a Public Key e o Access Token do ambiente de teste, com opções para copiá-los.

Tipo	Descrição
Public Key	Chave pública utilizada no frontend para inicializar a integração e proteger os dados enviados ao Mercado Pago.
Access Token	Chave privada utilizada no backend para autenticar as solicitações às APIs do Mercado Pago. Ela nunca deve ser compartilhada nem exposta no frontend.

Nessas integrações, o Access Token de teste começa com o prefixo APP_USR. Antes de copiar uma credencial, verifique se o seletor mostra o ambiente Teste.

Na tela Credenciais, você também encontrará um bloco independente com os dados da conta de teste e uma opção para administrá-la.

Compartilhar credenciais

Se outra pessoa estiver ajudando você a integrar os produtos do Mercado Pago, é possível compartilhar com ela as credenciais da aplicação de forma segura.

Para iniciar o processo, siga estas etapas:

1. Acesse Integrações, selecione a aplicação e clique em Credenciais no menu lateral.
2. Selecione o ambiente de Teste ou Produção.
3. Na seção Compartilhe as credenciais com um desenvolvedor, clique em Compartilhar credenciais.

Você pode desfazer essa ação excluindo a conta que recebeu as credenciais e renovando-as.

Renovar credenciais

Você pode renovar as credenciais de produção por motivos de segurança ou para revogar um acesso compartilhado.

A renovação gera um novo par de credenciais. Depois de concluí-la, substitua as credenciais anteriores pelas novas em todos os pontos da integração onde elas forem utilizadas.

Recomendações de segurança

Ao integrar as soluções do Mercado Pago, você estará lidando com dados sensíveis que precisam ser protegidos de possíveis perdas ou vulnerabilidades, como suas credenciais de acesso ao Mercado Pago, as chaves utilizadas nas suas integrações e as informações dos seus clientes.

Mostraremos como você pode otimizar a segurança de suas integrações de forma simples e rápida.

Envie o Access Token no header

Sempre que fizer chamadas à API, envie o Access Token no header ao invés de enviá-lo como query param. Essa prática aumenta a segurança, evitando que o token seja exposto a terceiros fora da sua integração.

Por exemplo, para enviar uma requisição GET ao recurso /users/me, utilize o seguinte formato:

curl
curl -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
https://api.mercadolibre.com/users/me

Use o OAuth para gerenciar credenciais de terceiros

OAuth é um protocolo de autorização que permite o acesso seguro de aplicações a contas de usuário em serviços HTTP, sem que esse usuário precise compartilhar suas credenciais diretamente. Funciona como um intermediário que facilita o acesso controlado aos dados do usuário por aplicações de terceiros.

Para mais informações, acesse a documentação.