Este endpoint possibilita a criação de um caixa (ponto de venda) em uma loja para o recebimento das vendas de produtos ou serviços. Em caso de sucesso, a requisição retornará uma resposta com o status 201.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO CONDICIONAL
id. Apenas dígitos são permitidos. O limite máximo permitido é de 20 caracteres. ObrOBRIGATÓRIO CONDICIONAL
external_id. O limite máximo permitido é de 60 caracteres. Obrigatório se store_id não for enviado. Se ambos foreactive (o caixa está ativado e disponível para receber pagamentos) e inactive (o caixa está desativado e não pode receber pagamentos).400Requisição inválida
bad_request
A requisição não pôde ser processada. Verifique se o body está em conformidade com o JSON schema, se pelo menos um dos campos store_id ou external_store_id está presente (se nenhum for enviado, o detalhe do erro será: one of 'store_id' or 'external_store_id' is required), e se o header X-Idempotency-Key está presente e não está vazio.
idempotency_key_already_used
O valor do X-Idempotency-Key enviado já foi utilizado em uma requisição anterior com um payload diferente. Gere um novo valor único para cada operação distinta.
invalid_external_store_id
O external_store_id enviado não corresponde à loja identificada pelo store_id. Quando ambos são enviados, devem se referir à mesma loja.
401Não autorizado
unauthorized
O valor enviado como Access Token está incorreto ou ausente. Verifique e tente novamente com um Access Token válido.
404Não encontrado
store_not_found
A loja identificada por store_id ou external_store_id não existe ou não pertence ao usuário do Access Token. Verifique se a loja existe e está associada à sua conta.
409Conflito
pos_already_exists
Já existe um caixa com o mesmo external_id para este usuário. O external_id deve ser único por caixa do usuário.
conflict
A mesma requisição já está sendo processada por outra chamada concorrente com o mesmo X-Idempotency-Key. Aguarde alguns segundos e tente novamente com a mesma chave e o mesmo payload.
422Entidade não processável
unprocessable_entity
A identificação do usuário não pôde ser resolvida a partir do Access Token. Verifique se o token é válido e está associado a uma conta ativa do Mercado Pago.
424Falha de dependência
internal_error_check_store_owner
Ocorreu um erro de comunicação ao validar a propriedade da loja. Trata-se de uma falha de dependência e não está relacionado aos dados da requisição. Por favor, tente novamente.
500Erro interno do servidor
internal_server_error
Ocorreu um erro inesperado no servidor. Trata-se de uma falha transitória não relacionada aos dados da requisição. Tente novamente após alguns instantes.
curl -X POST \
'https://api.mercadopago.com/v2/pos'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Idempotency-Key: f83ea2af-1a95-4c68-8f03-1aeac37642f2' \
-d '{
"name": "POS-001",
"store_id": "987654",
"external_id": "SUC001POS001"
}'{
"id": 1234567,
"name": "POS-001",
"status": "active",
"date_created": "2024-01-15T10:30:00Z",
"date_last_updated": "2024-03-01T08:00:00Z",
"user_id": 123456,
"external_id": "SUC001POS001",
"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"
},
"config": {
"qr": {
"operating_mode": "pdv"
}
}
}