Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

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

Parcerias

Conheça nosso programa para agĂȘncias ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratĂĄ-los.

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-7434*********159-03141*********cee51edf8*********f94f589-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"
}