Para iniciar o processo de configuração, é necessário ter uma conta empresa no Mercado Pago, que permitirá criar uma aplicação no Mercado Pago Developers. Veja abaixo como criar a sua conta empresa.

1. Acesse nossa página de registro e preencha os dados solicitados com as informações da carteira digital que você representa.
2. Em seguida, acesse o Mercado Pago Developers, faça login com a conta empresa correspondente à carteira e acesse Suas integrações no canto superior direito da tela.

3. Na tela seguinte, clique no botão Criar aplicação.

4. Você será redirecionado para a tela de Configurações básicas, onde deverá preencher 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á sendo criada. Você tem um limite de 50 caracteres.
• Como solução de pagamento a integrar, escolha a opção Pagamentos presenciais.
• Na pergunta sobre o produto a integrar, selecione a opção Código QR.
• Não é necessário selecionar o modelo de integração.

5. Por último, marque a caixa seleção para autorizar o uso de seus dados pessoais de acordo com a Declaração de Privacidade e certificar que sua conta usa 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 gerará automaticamente um cartão em Suas integrações com o nome e o número da aplicação, que permitirá acessar seus detalhes quando necessário.

Para continuar com a configuração do QR interoperável, é necessário que a carteira digital solicite o cadastro e sua incorporação ao Mercado Pago.

Para isso, entre em contato com nossa Central de Suporte e solicite apoio para a configuração do fluxo aceitador de QR interoperável, fornecendo as seguintes informações.

Com esses dados, nossa equipe de Suporte gerenciará a incorporação da carteira e confirmará posteriormente seu cadastro.

Para usar as APIs do Mercado Pago, é necessário obter as credenciais por meio do fluxo OAuth. Dessa forma, você poderá criar um Access Token que permitirá acessar os recursos da aplicação criada de forma segura.

Para obtê-lo, siga as etapas abaixo.

1. Em Suas integrações, selecione a aplicação criada para a carteira digital.
2. No menu à esquerda da tela, selecione a opção Credenciais de produção.
3. Localize as credenciais Client ID e Client Secret, que deverá usar para gerar o Access Token por meio do fluxo OAuth, conforme mostrado na imagem a seguir.

4. Envie um POST ao endpoint /oauth/token com os parâmetros obrigatórios descritos a seguir para gerar seu Access Token.

curl
Copiar
curl --location 'https://api.mercadopago.com/oauth/token' \
--header 'Content-Type: application/json' \
--data '{
 "client_id": "{YOUR_CLIENT_ID}",
 "client_secret": "{YOUR_CLIENT_SECRET}",
 "grant_type": "{YOUR_CLIENT_CREDENTIALS}"
}'

Na resposta à solicitação, você receberá, entre outros parâmetros, o Access Token que deverá usar nas chamadas às APIs do Mercado Pago.

json
Copiar
{
  "access_token": "APP_USR-{{TOKEN}}",
  "token_type": "Bearer",
  "expires_in": 21600,
  "scope": "offline_access read write",
  "user_id": "{USER_ID}",
  "live_mode": true
}

Ao configurar a interoperabilidade dos códigos QR do Mercado Pago, também é possível configurar o recebimento de notificações Webhooks para os pagamentos realizados.

Para isso, siga as etapas abaixo.

1. Acesse Suas integrações e selecione a aplicação criada para a carteira digital.
2. No menu à esquerda da tela, selecione a opção Notificações > Webhooks.
3. Na aba Modo produção, forneça a URL que será utilizada para receber as notificações.
4. Em Eventos, escolha a opção Pagamentos (interoperabilidade de cartões de crédito).

5. Clique em Salvar e confirme na tela seguinte.

Antes de ir para produção, leve em conta as seguintes considerações para garantir o funcionamento correto da sua integração.

• Utilize sempre o Access Token da carteira criado por meio do fluxo de Client Credentials de OAuth. Certifique-se de renová-lo antes de completar 6 horas.
• Certifique-se de oferecer sempre uma experiência de usuário adequada: forneça mensagens claras para otimizar a compreensão de cada cenário de pagamento, falha ou erro que ocorrer ao escanear os códigos QR utilizando a carteira.
• Lembre-se de incluir corretamente os padrões de códigos QR do Mercado Pago a partir de seu domínio. Na maioria dos casos, isso deve ser feito com um domínio invertido, como com.mercadolibre, mas também é possível encontrar QRs não EMVCO, como https://mpago.la/pos/<id> ou https://mpago.la/s/qr/<id1><id2>.
• Identifique as operações com códigos rastreáveis que permitam à COELSA reconhecer aquelas pertencentes ao Mercado Pago. Para isso, envie o order.id da IEP do Mercado Pago como qr_trx_id à API da COELSA.