Criar loja e caixa

Após criar a aplicação e obter as credenciais, é necessário configurar a loja e caixa, que estarão associados às transações.

As lojas representam estabelecimentos físicos cadastrados no Mercado Pago e podem ter um ou mais caixas vinculados. Já os caixas correspondem aos pontos de venda (PDVs) e devem sempre estar associados a uma loja, garantindo a conciliação de pagamentos por Código QR em estabelecimentos físicos.

É possível criar lojas e caixas a partir do seu sistema através das nossas APIs para pagamentos presenciais. Para isso, siga os passos a seguir.

Criar loja

Para criar uma loja via API, envie um POST incluindo seu Access Token de testeChave privada da aplicação criada no Mercado Pago, utilizada no backend. Você pode acessá-la em Suas integrações > Dados da integração > Testes > Credenciais de teste. Durante o processo de integração, utilize o Access Token de teste. Ao concluir a integração, substitua-o pelo Access Token de produção caso seja uma integração própria, ou pelo Access Token obtido via OAuth em integrações para terceiros. O Access Token de teste começa com o prefixo `APP_USR`.Acessar as credenciais de teste ao endpoint Criar lojaAPI. Você deverá adicionar o user_id da conta de testeDurante o desenvolvimento da integração, utilize o User ID da sua conta de teste, disponível em Suas integrações > Dados da integração > Credenciais de teste > Dados das credenciais de teste. Ao subir em produção, substitua-o pelo User ID da conta real do Mercado Pago que receberá os pagamentos. no path da sua requisição e completar os parâmetros requeridos com os detalhes do negócio conforme se indica a seguir.

curl
curl -X POST \
    'https://api.mercadopago.com/users/USER_ID/stores'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer ACCESS_TOKEN' \
    -d '{
  "name": "Loja Instore",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "external_id": "LOJ001",
  "location": {
    "street_number": "0123",
    "street_name": "Nome da rua de exemplo.",
    "city_name": "Nome da cidade.",
    "state_name": "Nome do estado.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Perto do Mercado Pago."
  }
}'

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": "Perto do Mercado Pago"
  },
  "external_id": "LOJ001"
}

Além dos dados enviados na solicitação, o endpoint retornará o identificador atribuído à loja pelo Mercado Pago sob o parâmetro id.

Criar caixa

Para habilitar vendas com Mercado Pago, é indispensável que cada loja registrada tenha pelo menos um caixa vinculado. Para criar um caixa e associá-lo à loja previamente criada, envie um POST incluindo seu Access Token de testeChave privada da aplicação criada no Mercado Pago, utilizada no backend. Você pode acessá-la em Suas integrações > Dados da integração > Testes > Credenciais de teste. Durante o processo de integração, utilize o Access Token de teste. Ao concluir a integração, substitua-o pelo Access Token de produção caso seja uma integração própria, ou pelo Access Token obtido via OAuth em integrações para terceiros. O Access Token de teste começa com o prefixo `APP_USR`.Acessar as credenciais de teste ao endpoint Criar caixaAPI como mostrado a seguir.

curl
curl -X POST \
    'https://api.mercadopago.com/v2/pos'\
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ACCESS_TOKEN' \
    -H 'X-Idempotency-Key: CHAVE_UNICA' \
    -d '{
  "name": "POS-001",
  "store_id": "1234567",
  "external_id": "LOJ001POS001",
  "config": {
    "qr": {
      "operating_mode": "pdv"
    }
  }
}'

Se a solicitação foi enviada corretamente, a resposta será como o exemplo a seguir.

json
{
  "id": 1234567,
  "name": "POS-001",
  "status": "active",
  "date_created": "2024-01-15T10:30:00Z",
  "date_last_updated": "2024-01-15T10:30:00Z",
  "user_id": 123456,
  "store_id": "1234567",
  "external_store_id": "LOJ001",
  "external_id": "LOJ001POS001",
  "config": {
    "qr": {
      "operating_mode": "pdv"
    }
  },
  "qr_response": {
    "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
    "image": "https://www.mercadopago.com/instore/merchant/qr/1234567/abc123.png",
    "template_document": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.pdf",
    "template_image": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.png",
    "qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/abc123"
  }
}

Veja na tabela abaixo a descrição de alguns dos parâmetros retornados que podem ser úteis para continuar com sua integração mais adiante.

Se ambas as solicitações foram bem-sucedidas, você terá criado e configurado a loja e o caixa necessários para a integração com Código QR.

Com a loja e o caixa criados, você poderá integrar o processamento de pagamentos.