Configurar ambiente
Siga os passos abaixo para configurar o ambiente que permitirá operar com códigos QR do Mercado Pago de fluxo aceitador.
1. Criar conta empresarial e aplicação no Mercado Pago
Para iniciar o processo de configuração, é necessário ter uma conta empresarial no Mercado Pago, que permitirá criar um aplicação no Mercado Pago Developers.
Para criar sua conta empresarial, acesse nossa página de registro e preencha os dados solicitados com as informações relativas à carteira digital que você representa.
Em seguida, acesse o Mercado Pago Developers, faça login com a conta empresarial correspondente à carteira, e clique em Suas integrações no canto superior direito da tela.
Na tela seguinte, clique no botão Criar aplicação.
Isso te redirecionará para a tela Configurações básicas, onde você deverá completar as informações solicitadas conforme indicado a seguir:
- Nome da aplicação: escolha um nome para a aplicação, associado à carteira para a qual está criando. Você tem um limite de 50 caracteres.
- Como solução de pagamento a integrar, escolha a opção Pagamentos presenciais.
- Na pergunta referente ao produto a integrar, selecione a opção Código QR. Não é necessário selecionar o modelo de integração.
Por fim, marque a caixa de seleção para autorizar o uso de seus dados pessoais de acordo com a Declaração de Privacidade e certifique-se de que sua conta utiliza as ferramentas do Mercado Pago de acordo com os Termos e Condições, assim como a caixa de seleção Não sou um robô e clique em Criar aplicação.
Isso irá gerar automaticamente um card em Suas integrações com o nome e o número do aplicativo, que permitirá acessar seus detalhes quando necessário.
2. Solicitar cadastro e incorporação da carteira
Para continuar com a configuração do QR interoperável, é necessário que a carteira digital solicite o cadastroe sua incorporação ao Mercado Pago.
Para isso, você deve entrar em contato com nossa Central de Ajuda e solicitar suporte para a configuração do fluxo aceitador de QR interoperável, fornecendo as seguintes informações.
Dado | Descrição |
identifier | Nome comercial da carteira digital, como é conhecida no mercado. |
application_id | É o identificador da aplicação criada para a carteira digital. Você pode encontrá-lo como Número da aplicação dentro de Detalhes da aplicação. |
user_business_id | Identificador do usuário criador da aplicação para a carteira digital. Você pode encontrá-lo como User ID dentro de Detalhes da aplicação. |
Com essas informações, nossa equipe de Suporte gerenciará a incorporação da carteira e confirmará posteriormente o seu cadastro.
3. Obter credenciais
Para poder utilizar as APIs do Mercado Pago, é necessário obter as credenciais através do fluxo OAuth. Dessa forma, você poderá criar um Access Token que permitirá acessar os recursos da aplicação criada de maneira segura.
Para obtê-lo, siga os passos abaixo:
- Dentro de Suas integrações, selecione a aplicação criada para a carteira digital.
- No menu exibido à esquerda da tela, selecione a opção Credenciais de produção.
- Localize as credenciais Client ID e Client Secret, que você deverá utilizar para gerar o Access Token através do fluxo OAuth, conforme mostrado na imagem a seguir.
- Envie um POST para o endpoint /oauth/token com os parâmetros obrigatórios descritos a seguir para gerar seu Access Token.
curl
curl --location 'https://api.mercadopago.com/oauth/token' \
--header 'Content-Type: application/json' \
--data '{
"client_id": "{CLIENT_ID}",
"client_secret": "{CLIENT_SECRET}",
"grant_type": "client_credentials"
}'
Campo | Descrição |
client_id | Copie e cole o valor atribuído ao Client ID na seção Credenciais dentro de “Suas integrações". |
client_secret | Copie e cole o valor atribuído ao Client Secret na seção Credenciais dentro de "Suas integrações". |
grant_type | O protocolo OAuth permite obter um Access Token através de diferentes fluxos de acesso (grant types). Neste caso, você deve preencher o campo com o valor ‘client_credentials’, que permite obtê-lo para acessar seus próprios recursos. Consulte mais informações sobre esse fluxo em Obter Access Token. |
Na resposta à solicitação, você receberá, entre outros parâmetros, seu Access Token, que deverá ser utilizado nas chamadas às APIs do Mercado Pago que você realizar uma vez que tenha o cadastro da carteira, concedida pela nossa equipe de Suporte.
json
{
"access_token": "{ACCESS_TOKEN}",
"token_type": "Bearer",
"expires_in": 21600,
"scope": "offline_access read write",
"user_id": {USER_ID},
"live_mode": true
}
4. Configurar notificações Webhooks (exclusivo para pagamentos com cartão de crédito)
Ao configurar a interoperabilidade dos Códigos QR do Mercado Pago, também é possível configurar a recepção de notificações Webhooks para os pagamentos realizados com cartão de crédito.
Para fazer isso, siga os passos abaixo:
- Acesse Suas integrações e selecione a aplicação criada para a carteira digital.
- No menu exibido à esquerda da tela, selecione a opção Notificações > Webhooks.
- Na aba Modo de produção, forneça a URL que será utilizada para receber as notificações.
- Em Eventos, escolha a opção Pagamentos (interoperabilidade de cartões de crédito).
- Clique em Salvar e confirme na tela seguinte.