Pré-requisitos - QR Code - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

Pré-requisitos

Considere os pontos a seguir antes de começar:

  • Acesse a uma conta
  • Crie uma aplicação
  • Gere usuários de teste
  • Obtenha o seu Access Token
  • Identifique a sua integração

1. Acesse uma conta

Para começar a integração, você precisa ter uma conta no Mercado Pago ou Mercado Livre.

Você pode Acessar uma conta existente ou Criar uma nova conta.

2. Crie uma aplicação

Para realizar transações através da integração do Mercado Pago é necessário criar uma credencial. Essa credencial terá uma identificação, assim como um Access Token que permitirá fazer transações usando uma conta Mercado Pago.

Crie uma aplicação para obter as credenciais e configurar notificações webhooks.

É muito simples, veja como:

  1. Acesse Suas aplicações.
  2. Selecione o símbolo em Suas aplicações para criar uma nova aplicação.
  3. Nomeie a aplicação para identificação posterior.
  4. Aceite nossos Termos e Condições. E pronto!
Nota
Caso o PDV integrado tenha várias conexões com contas Mercado Pago, consulte os itens 4 e 5. Fique atento à segurança da sua integração e implemente OAuth.

3. Gere usuários de teste

Utilize contas de teste para garantir que sua integração dê suporte a todos os fluxos e cenários possíveis. Elas têm os mesmos recursos de uma conta real do Mercado Pago, o que permite testar o funcionamento das integrações que você está desenvolvendo.

Para realizar um teste é preciso ter pelo menos duas contas:

  • Vendedor: conta necessária para configurar a aplicação e as credenciais para a cobrança. Esta é a sua conta de usuário.
  • Comprador: conta necessária para testar o processo de compra.

Além dessas contas, é importante também utilizar os cartões de teste para testar a integração de pagamento e simular o processo de compra, assim como o saldo na conta do Mercado Pago do usuário de teste. Veja mais detalhes abaixo.

testuser

Para criar contas e testar o funcionamento das integrações, siga os passos abaixo.

  1. No Devsite, navegue até Suas integrações e clique no card correspondente à sua aplicação.
  2. Na página da aplicação, vá até a seção Contas de teste e clique no botão + Criar conta de teste.
  3. Na tela "Criar nova conta", insira uma descrição para identificação da conta. Exemplo: "Vendedor - loja 1".
  4. Em seguida, selecione o país de operação da conta. Essa informação não poderá ser editada posteriormente e, além disso, os usuários Comprador e Vendedor precisam ser do mesmo país.
  5. Preencha com um valor fictício em dinheiro que servirá como referência para você testar suas aplicações. Esse valor aparecerá como saldo na conta do Mercado Pago do usuário de teste e poderá ser utilizado para simulação de pagamentos, assim como com os cartões de teste.
  6. Autorize o uso dos seus dados pessoais conforme a Declaração de Privacidade e certifique que sua conta usa as ferramentas do Mercado Pago de acordo com os Termos e condições marcando a caixa de seleção.
  7. Clique em Criar conta de teste.
Atenção
Sempre que utilizar um usuário de teste, você deve usar suas credenciais de produção.

Pronto! A conta de teste foi criada e será exibida na tabela com as seguintes informações:

  • País: Local de origem da conta selecionado em seu cadastro.
  • Identificação da conta: Descrição para identificação da conta de teste.
  • Usuário: Username da conta de teste gerado automaticamente. Esse é o username utilizado para fazer login com o test user.
  • Senha: Senha de acesso à conta do usuário de teste gerada automaticamente. Para gerar uma nova senha, clique nos 3 pontos verticais ao final da linha da tabela e selecione a opção Gerar nova senha.
  • Criado em: Data em que a conta de teste foi criada.
Importante
Para editar a identificação da conta ou adicionar mais dinheiro fictício para testar suas aplicações, clique nos 3 pontos verticais ao final da linha da tabela e selecione a opção Editar dados.

Você pode gerar até 15 contas de usuários de teste ao mesmo tempo e, por enquanto, ainda não é possível deletá-las.

Após a geração dos usuários de teste, você pode começar a integração e criar as lojas e os caixas.

4. Obtenha o seu Access Token (OAuth)

Se você é um integrador que trabalha com diversas lojas que operam com o Mercado Pago, recomendamos que faça o OAuth - autenticação entre contas*. Através do processo o vendedor autoriza o compartilhamento seguro dos seus dados com um sistema de terceiros.

O Access Token não poderá ser compartilhado de outra maneira que não seja o OAuth.

5. Identifique a sua integração (Sponsor ID)

Para identificar os pedidos realizados pelo seu ponto de venda, inclua o sponsor ID e confira as nossas APIs de Pedidos presenciais para saber como enviar esta informação.

Passo a Passo:

  • Crie uma conta no portal do Mercado Pago (Integrator ID).
  • Obtenha o Collector ID (Cust ID ou User ID) da sua conta.
  • Inclua o Collector ID da sua conta de integrador no Sponsor ID do vendedor.
  • Envie o Sponsor ID em todas as transações QR. Consulte a API .