Requisitos prévios para a integração
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:
- Acesse Suas aplicações.
- Selecione o símbolo em Suas aplicações para criar uma nova aplicação.
- Nomeie a aplicação para identificação posterior.
- Aceite nossos Termos e Condições. E pronto!
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.
Para criar contas e testar o funcionamento das integrações, siga os passos abaixo.
- No Devsite, acesse o menu Suas integrações > Contas de teste e clique no botão Criar conta de teste.
- Na tela "Criar nova Conta", insira uma descrição para identificação da conta. Exemplo: "Vendedor - loja 1".
- 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.
- 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.
- Clique em Criar conta de teste.
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.
- Data de criação: data em que a conta de teste foi criada.
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: