Inicio
Documentação
Recursos
Certificações
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Criar caixa - Caixas - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Criar caixa

POST

https://api.mercadopago.com/pos
Este endpoint possibilita a criação de uma caixa (ponto de venda) em uma loja para o recebimento das vendas de produtos ou serviços. Cada caixa terá um código QR exclusivo vinculado a ela.
Parâmetros de requisição
BODY
name
string
Nome do ponto de venda.
fixed_amount
boolean
Determine se o cliente pode inserir o valor a ser pago.
store_id
string
Identificador da loja à qual o ponto de venda pertence.
external_store_id
string
Identificador único da loja, definido pelo sistema integrador e pode conter até 60 caracteres.
Parâmetros de resposta
id
number
ID de criação do ponto de venda. Ao registrar um ponto de venda, você receberá um ID correspondente. Esse ID pode ser utilizado para várias operações, incluindo consultar os dados do ponto de venda.
qr
object
Código QR criado automaticamente para receber os pagamentos do ponto de venda.
status
string
Status de criação do ponto de venda.
date_created
string
Data de criação da caixa. Este campo exibe a data e hora no formato ISO 8601, como 2024-08-08T19:29:45.019Z.
Erros

400Erro

MISSING_BODY

O corpo do HTTP é necessário para modificar o ponto de venda.

UNKNOWN_FIELD_EXCEPTION

O campo indicado não é permitido para esta operação ou é desconhecido.

INVALID_POS_ID

O ID do ponto de venda é inválida, deve ser numérica.

INVALID_NAME

NAME deve ser string.

NAME_TOO_LONG

NAME deve ter menos de 45 caracteres.

INVALID_FIXED_AMOUNT

FIXED_AMOUNT deve ser boolean.

INVALID_CATEGORY

CATEGORY deve ser numérico.

POS_UNKNOWN_MCC

CATEGORY deve ser válida para o site do usuário.

POS_INVALID_STORE_ID

STORE_ID deve ser numérico.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID deve ser string.

EXTERNAL_STORE_ID_NOT_MATCH

O EXTERNAL_STORE_ID não se refere ao STORE_ID indicado.

INEXISTENT_EXTERNAL_STORE_ID

O EXTERNAL_STORE_ID não se refere a uma loja existente.

INVALID_EXTERNAL_ID

O campo EXTERNAL_ID deve ser alfanumérico, apenas letras e números. Sem espaços, hífens ou caracteres especiais.

EXTERNAL_ID_TOO_LONG

O EXTERNAL_ID deve ter menos de 40 caracteres.

INVALID_URL

A URL deve ser uma string e deve ter o formato de uma URL válida.

URL_TOO_LONG

A URL deve ter menos de 300 caracteres.

FIXED_AMOUNT_FALSE

Se o campo URL estiver indicado, o campo FIXED_AMOUNT deve ser verdadeiro. Não suportamos a modalidade de valor aberto nesse caso.

non_existent_external_store_id

O External Store ID não se refere a nenhuma loja.

409Erro

point_of_sale_exists

Já existe um ponto de venda com o mesmo EXTERNAL_ID.

Requisição
curl -X POST \
    'https://api.mercadopago.com/pos'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
    -d '{
  "name": "First POS",
  "fixed_amount": false,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001",
  "category": 621102
}'
Resposta de exemplo
{
  "id": 2711382,
  "qr": {
    "image": "https://www.mercadopago.com/instore/merchant/qr/2711382/0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png",
    "template_document": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.pdf",
    "template_image": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png"
  },
  "status": "active",
  "date_created": "2019-08-22T14:11:12.000Z",
  "date_last_updated": "2019-08-25T15:16:12.000Z",
  "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
  "user_id": 446566691,
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001"
}