Recursos para IA

Credenciais

As credenciais são chaves de acesso únicas com as quais identificamos uma integração em sua conta. Elas estão vinculadas à aplicaçãoEntidade registrada no Mercado Pago que identifica uma integração e reúne suas configurações e credenciais.Ver dados da integração que você criou para sua integração.

A forma de obtê-las e gerenciá-las varia de acordo com o produto integrado.

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 ao passar de teste para produção.

Credenciais de teste

As credenciais de teste permitem configurar e validar a integração sem processar pagamentos 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 um dos seguintes caminhos:
    • 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.

TipoDescrição
Public KeyChave pública utilizada no frontend para inicializar a integração e proteger os dados enviados ao Mercado Pago.
Access TokenChave privada utilizada no backend para autenticar as solicitações às APIs do Mercado Pago. Nunca deve ser compartilhada nem exposta no frontend.

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

Na tela Credenciais, você também encontrará um bloco independente com os dados da conta de teste e um acesso para gerenciá-la.

Acessos às credenciais pelo Início e pelo menu lateral

Credenciais de produção

As credenciais de produção permitem processar pagamentos reais. Antes de utilizá-las, você deve ativar o ambiente de produção da aplicação.

Para ativar o ambiente de produção e obter as credenciais, siga estas etapas:

  1. Acesse Integrações e selecione a aplicação.

  2. Clique em Credenciais no menu lateral.

  3. Selecione Produção no seletor de ambiente e clique em Ativar ambiente de produção.

  4. Preencha o setor de atuação e o site do seu negócio.

  5. Aceite a Declaração de Privacidade e os Termos e condições. Depois, clique em Ativar.

Após ativar o ambiente, você encontrará as credenciais de produção disponíveis para a aplicação: Public Key, Access Token, Client ID e Client Secret. Substitua a Public Key e o Access Token de teste pelos de produção antes de começar a processar operações reais.

Credenciais de produção da aplicação

A Public Key e o Access Token são utilizados para integrar os pagamentos. O Client ID e o Client Secret são utilizados principalmente em integrações que implementam OAuth, especialmente por meio do fluxo Client Credentials.

TipoDescrição
Public KeyChave pública vinculada a uma aplicação, utilizada no frontend para inicializar a integração durante operações reais.
Access TokenChave privada de produção utilizada no backend para autenticar as solicitações às APIs do Mercado Pago. Nunca deve ser compartilhada nem exposta no frontend.
Client IDIdentificador único que representa a aplicação em integrações que implementam OAuth.
Client SecretChave privada utilizada junto com o Client ID para autenticar a aplicação. Nunca deve ser compartilhada nem exposta no frontend.

Antes de copiar uma credencial, verifique se o seletor exibe o ambiente Produção.

Compartilhar credenciais

Se outra pessoa ajudar 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, no menu lateral, clique em Credenciais.
  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.