Integrar API - Integrar com PDV - Mercado Pago Developers

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:

  1. Vá em Suas integrações.
  2. 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.
  3. Dê a sua aplicação um nome com o qual você possa se identificar mais tarde.
  4. Escolha "Mercado Pago Point" como o produto que você vai integrar.
  5. Aceite nossos Termos e Condições.

E pronto!

Nota
Se você vai realizar operações em nome de outros vendedores, pode gerenciar a ligação segura integrando OAuth.

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.

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.

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"
}'
Importante
O modo integrado da API para PDVs está disponível apenas para ser operado por um operador de loja. Caso seja implementado em modo de autoatendimento, será de total responsabilidade do negócio, uma vez que os dispositivos não estão habilitados para serem utilizados neste tipo de modelo de negócio.

Você receberá uma resposta como esta:

json

{
"operating_mode": "PDV"
}
Caso necessite usar o dispositivo em modo não integrado, deve-se configurar o campo operating_mode com o valor STANDALONE.
Importante
É necessário reiniciar o dispositivo para que a alteração tenha efeito.