Integre a API aos seus pontos de venda
Siga estas etapas para começar a integrar a API de integrações aos seus pontos de venda.
1. Obtenha credenciais de identificação
Acesse uma conta no Mercado Pago
Para iniciar a integração, é necessário ter uma conta no Mercado Pago ou no Mercado Livre. Você pode Entrar em uma conta existente ou Criar uma nova conta.
Crie uma aplicação
Em seguida, você precisará criar uma aplicação para obter as credenciais. É fácil, explicamos como fazer:
- Vá em Suas integrações.
- Na seção Suas aplicações, clique no símbolo "+" para criar sua primeira aplicação ou escolha "Criar nova aplicação" se você já tiver outras.
- Dê a sua aplicação um nome com o qual você possa se identificar mais tarde.
- Escolha "Mercado Pago Point" como o produto que você vai integrar.
- Aceite nossos Termos e Condições.
E pronto!
Acesse as credenciais da sua aplicação
Depois de criar uma aplicação, você poderá acessar as suas credenciais. Você pode localizá-las em Detalhes da aplicação > Credenciais dentro do Painel do desenvolvedor. Com elas você pode conectar uma integração à sua conta e configurá-la do seu jeito.
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, navegue até Suas integrações e clique no card correspondente à sua aplicação.
- Na página da aplicação, vá até a seção 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.
- 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.
- 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.
- Criado em: Data em que a conta de teste foi criada.
Além disso, você também poderá criar usuários de teste utilizando o seguinte comando:
curl
curl -X POST \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ${TEST_ACCESS_TOKEN}' \
"https://api.mercadopago.com/users/test" \
-d '{"site_id":"MLA","description" : "a description"}'
2. Associe o seu dispositivo Point à sua conta do Mercado Pago
Agora você vai vincular seu dispositivo Point à sua conta do Mercado Pago. Para isso, você precisa ter nosso aplicativo no seu celular. Você pode obtê-lo para sistemas operacionais iOS e Android. Você também deve ter um dispositivo Point.
Digitalize o código QR do seu dispositivo Point
Faça login no aplicativo do Mercado Pago e, em seguida, clique no ícone QR e leia o código que aparece quando você liga o dispositivo Point.
Pronto! Seu dispositivo Point será vinculado à sua conta.
Configure sua loja e sua caixa
Depois de vincular seu dispositivo Point à sua conta do Mercado Pago, você deve preencher seus dados comerciais e configurar sua caixa registradora no site do Mercado Pago. Para fazer isso, você deve inserir as informações em Sua loja > Lojas e caixas.
Ative o modo integrado no seu dispositivo Point
Para integrar seu dispositivo Point com a nossa API, é necessário ativar o modo de operação ponto de venda (PDV). Para fazer isso, consulte os dispositivos através de nosssa API Obter dispositivos e execute o seguinte comando:
bash
curl --location --request PATCH 'https://api.mercadopago.com/point/integration-api/devices/:deviceId' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
"operating_mode": "PDV"
}'
Você receberá uma resposta como esta:
json
{
"operating_mode": "PDV"
}
operating_mode
com o valor STANDALONE
.