Credenciais
As credenciais são chaves de acesso exclusivas usadas para identificar uma integração em sua conta. Elas desempenham um papel fundamental na captura segura de pagamentos em lojas virtuais e outras aplicações.
Cada aplicação contará com dois pares de credenciais de produção e, quando aplicável ao produto, um par de credenciais de teste.
Obter credenciais
Para obter as credenciais, sejam elas de produção ou de teste, primeiro você deverá criar uma aplicação no Mercado Pago. Caso ainda não tenha criado uma, acesse a documentação Painel do Desenvolvedor para mais informações.
Veja abaixo como obter as credenciais e em quais situações elas devem ser utilizadas.
Credenciais de produção
As credenciais de produção são um conjunto de chaves de acesso que permitem receber pagamentos reais em lojas e em outras aplicações.
Você poderá obter as suas credenciais de produção de duas maneiras:
- Accesando Suas integrações > "Sua aplicação" > Produção > Credenciais de produção a partir do Painel do desenvolvedor.
- Através da sua conta do Mercado Pago, acesse Sua loja > Configurações > Gestão e administração > Credenciais.
Ao acessar suas credenciais de produção, serão exibidos os seguintes pares de credenciais: Public Key e Access Token, além de Client ID e Client Secret.
Public Key e Access Token
A Public Key e o Access Token são as credenciais utilizadas, não necessariamente em conjunto, nas integrações com as soluções de pagamento do Mercado Pago, incluindo:
Essas credenciais também são utilizadas nas integrações dos plugins do Mercado Pago com plataformas de e-commerce.
Tipo | Descrição |
Public key | Chave pública da aplicação geralmente usada no frontend. Ela permite, por exemplo, acessar informações sobre os meios de pagamento e criptografar os dados do cartão. |
Access token | Chave privada da aplicação que deve ser usada exclusivamente no backend para gerar pagamentos. É essencial que essa informação seja mantida segura em seus servidores. |
Para obter mais informações sobre quais credenciais serão necessárias para a sua integração, consulte a documentação específica da solução que está sendo integrada.
Client ID e Client Secret
O Client ID e o Client Secret são credenciais utilizadas em algumas integrações mais antigas com plataformas de comércio eletrônico e, principalmente, nas integrações que utilizam OAuth como protocolo para obtenção de informações privadas de contas do Mercado Pago. Especificamente, são utilizados durante o fluxo (grant type) de Client credentials, o qual permite acessar um recurso em nome próprio e obter um Access Token sem interação do usuário.
Tipo | Descrição |
Client ID | Identificador único que representa sua integração. |
Client secret | Chave privada usada em alguns plugins para gerar pagamentos. É essencial manter essa informação segura em seus servidores, garantindo que nenhum usuário ou invasor tenha acesso a ela. |
Credenciais de teste
As credenciais de teste são um conjunto de chaves usadas para testar a integração. Elas podem ser combinadas com cartões de crédito de teste para simular transações e verificar o correto funcionamento das integrações.
Para obter suas credenciais de teste, desde que estas estejam disponíveis para sua integração, acesse Suas integrações > "Sua aplicação" > Credenciais de teste.
Se ao criar um aplicativo você selecionou um produto do Mercado Pago que não requer credenciais de teste, a seguinte tela será exibida:
Se você estiver integrando um produto que não utiliza credenciais de teste, você não poderá usá-las. Em vez disso, utilize as contas de teste para testar sua integração corretamente.
Compartilhar credenciais
Ao receber assistência na integração ou configuração dos seus canais de pagamento, é possível compartilhar suas credenciais de forma segura com outra conta do Mercado Pago. Você pode fazer isso de duas maneiras:
Através das Suas integrações no Mercado Pago Developers:
- Acesse Suas integrações e acesse a aplicação desejada.
- Vá para a seção Testes ou Produção, a depender do tipo de credencial que deseja compartilhar.
- Uma vez selecionadas as credenciais, vá para a seção Compartilhar as credenciais com um desenvolvedor e clique no botão Compartilhar credenciais.
- Insira o endereço de e-mail de quem deseja conceder o acesso. Lembre-se de que é obrigatório que o endereço de e-mail esteja associado a uma conta do Mercado Pago.
Através do Mercado Pago:
- Acesse sua conta do Mercado Pago.
- Vá para Seu negócio > Configurações > Gestão e Administração > Credenciais.
- Nessa página, selecione as credenciais de produção ou as credenciais de teste, a depender do tipo de credencial que deseja compartilhar.
- Uma vez selecionadas as credenciais, vá para a seção Compartilhar as credenciais com um desenvolvedor e clique no botão Compartilhar credenciais.
- Selecione o aplicativo do qual deseja compartilhar suas credenciais e insira o endereço de e-mail de quem deseja conceder acesso. Lembre-se de que o endereço de e-mail deve obrigatoriamente estar associado a uma conta do Mercado Pago.
Renovar credenciais
Se por motivos de segurança ou qualquer outra razão relevante você precisar renovar suas credenciais, clique em Mais opções (três pontos no final do cartão) > Renovar.