Criar loja e caixa - Etapas de integração - Mercado Pago Developers
Criar loja e caixa
Após configurar o ambiente do terminal debug para receber o seu SmartApp, integrar e testar o fluxo de pagamento do nosso SDK, será necessário criar as lojas e caixas que serão responsáveis pela operação desses terminals antes de enviar seu aplicativo para validação e distribuição nos terminals.
Uma loja representa uma loja física dentro do Mercado Pago, que pode ter um ou mais caixas vinculados. No entanto, cada caixa permite apenas um terminal associado. Isso significa que, se você está querendo integrar mais de um terminal, deverá criar a mesma quantidade de caixas e realizar sua associação de maneira individual.
A criação e a configuração de lojas e caixas podem ser realizadas por duas vias: a partir do painel do Mercado Pago ou via API. Esta última opção é útil para sistemas que requeiram operar com vários pontos de venda, já que permite associar várias lojas a partir do sistema integrador.
É possível criar lojas e caixas a partir do seu sistema através de nossas APIs para pagamentos presenciais. Para isso, siga os passos abaixo.
Para criar uma loja via API, envie um POST com o Access Token que corresponda ao seu tipo de integração (para um terminal próprioIntegrações de Mercado Pago Point ao seu sistema para uso próprio e configuradas a partir de credenciais de produção da sua aplicação. Para mais informações, acesse o link abaixo.Acessar as credenciais ou para terceirosIntegrações de Mercado Pago Point ao seu sistema em nome de um vendedor e configuradas a partir de credenciais obtidas por meio do protocolo de segurança OAuth. Para mais informações, acesse o link abaixo.Acessar as credenciais) ao endpoint Criar lojaAPI. Você deverá adicionar o user_id da conta do Mercado Pago que receberá o dinheiro das transações no path da sua solicitação e completar os parâmetros requeridos com os detalhes do negócio conforme se indica a seguir.
É fundamental preencher corretamente todas as informações de localização da loja (city_name, state_name, latitude e longitude). Dados incorretos podem causar erros nos cálculos de impostos, impactando diretamente o faturamento e a regularização fiscal da sua empresa.
Identificador da conta do Mercado Pago que recebe o dinheiro pelas vendas realizadas na loja. Se você está realizando uma integração para um terminal próprioIntegrações de Mercado Pago Point ao seu sistema para uso próprio e configuradas a partir de credenciais de produção da sua aplicação. Para mais informações, acesse o link abaixo.Acessar as credenciais, encontrará este valor nos Detalhes da aplicação. Se, ao contrário, está realizando uma integração para terceirosIntegrações de Mercado Pago Point ao seu sistema em nome de um vendedor e configuradas a partir de credenciais obtidas por meio do protocolo de segurança OAuth. Para mais informações, acesse o link abaixo.Acessar as credenciais, obterá o valor na resposta à vinculação por meio de OAuthChave privada gerada mediante o protocolo de segurança OAuth, que permite gerenciar integrações em nome de terceiros. Para mais informações, dirija-se à documentação.OAuth.
name
Obrigatório
Nome da loja criada.
external_id
Opcional
Identificador externo da loja para o sistema do integrador. Pode conter qualquer valor alfanumérico de até 60 caracteres, e deve ser único para cada loja. Por exemplo, LOJMercadoPago.
location
Obrigatório
Este objeto deve conter todas as informações da localização da loja. É importante preencher tudo corretamente, especialmente latitude e longitude, usando o formato decimal simples e os dados reais do local. Por exemplo, "latitude": 27.175193925922862, e "longitude": 78.04213533235064 correspondem à localização exata do Taj Mahal, na Índia.
Se a solicitação foi enviada corretamente, a resposta será como o exemplo a seguir.
json
{
"id": 1234567,
"name": "Loja Instore",
"date_created": "2019-08-08T19:29:45.019Z",
"business_hours": {
"monday": [
{
"open": "08:00",
"close": "12:00"
}
],
"tuesday": [
{
"open": "09:00",
"close": "18:00"
}
]
},
"location": {
"address_line": "Nome da Rua de Exemplo, 0123, Nome da cidade, Nome do estado.",
"latitude": 27.175193925922862,
"longitude": 78.04213533235064,
"reference": "Próximo ao Mercado Pago"
},
"external_id": "LOJ001"
}
Além dos dados enviados na solicitação, retornará o identificador atribuído a essa loja pelo Mercado Pago sob o parâmetro id.
A criação de lojas e caixas por meio do Painel do Mercado Pago é a opção para quem deve gerenciar apenas um ponto de venda e prefere simplificar o processo. Para fazê-lo, acesse sua conta do Mercado Pago e siga as instruções abaixo.
No menu lateral esquerdo, dirija-se a Seu negócio > Lojas e caixas.
Na seção "Lista de lojas", clique no botão + Adicionar loja.
Complete o Nome e o Endereço do seu novo local, adicione opcionalmente Dados extras, caso precise de maior detalhamento, e clique em Continuar.
Complete as informações requeridas com o horário de funcionamento da loja, selecionando os dias e horários de abertura. Ao terminar, clique em Continuar.
As opções disponíveis nesta tela se adequam a múltiplos cenários, permitindo selecionar um único horário para todos os dias da semana ou um horário diferente para cada um, junto com a possibilidade de inserir horários especiais para feriados. Escolha a opção que melhor se adapte à sua loja.
A seguir, você se encontrará na tela para "Criar caixas" associados ao local, onde deverá atribuir um Nome. Se desejar, pode criar mais de um caixa.
Lembre-se de que só é possível configurar um terminal Point por caixa. Se deseja integrar vários terminals, deverá criar um caixa para cada um deles.
Clique no botão Continuar e pronto! Você já criou e configurou sua loja e seu caixa.
Os IDs retornados (store_id e pos_id) após a criação das lojas e caixas deverão ser informados ao seu representante do Mercado Pago. Com isso, será possível seguir com o processo de publicação do SmartApp.