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 ação do terminal - ImpressÔes - Mercado Pago Developers
Criar ação do terminal

POST

https://api.mercadopago.com/terminals/v1/actions
Este endpoint permite a criação de uma nova ação de impressão para Mercado Pago Point. O formato Base64 é compatível com imagens. Em caso de sucesso, a resposta retornarå um código de status 201.
Parùmetros de requisição
HEADER
X-Idempotency-Key
string

OBRIGATÓRIO

Esta função permite repetir solicitaçÔes de forma segura, sem o risco de realizar a mesma ação mais de uma vez por engano. Isso Ă© Ăștil para evitar erros, como a criação de dois pagamentos idĂȘnticos. Para garantir que cad...Ver mais
BODY
type
string

OBRIGATÓRIO

Tipo de ação associado Ă  solução Mercado Pago para a qual foi criado. No momento, o Ășnico valor suportado Ă© "print".
print: Valor associado à criação de açÔes de impressão para o Ponto de Venda.
external_reference
string

OBRIGATÓRIO

É a referĂȘncia externa da ação, atribuĂ­da no momento da criação. O limite mĂĄximo permitido Ă© de 64 caracteres e os permitidos sĂŁo: letras maiĂșsculas e minĂșsculas, nĂșmeros e os sĂ­mbolos de hĂ­fen (-) e sublinhado (_).
config
object

OBRIGATÓRIO

Configuração do tipo de ação.
content
string

OBRIGATÓRIO

String que contĂ©m as informaçÔes a serem impressas na Point. Se o subtipo for "custom", deve conter a string formatada com as tags suportadas; se for "image", deve conter o conteĂșdo da imagem em base64.
ParĂąmetros de resposta
id
string
Identificador da ação criada na requisição, gerado automaticamente pelo Mercado Pago.
type
string
Tipo de ação.
print: Ação de impressão criada para Point.
external_reference
string
É a referĂȘncia externa da ação, atribuĂ­da no momento da criação. O limite mĂĄximo permitido Ă© de 64 caracteres. Os caracteres permitidos sĂŁo: letras maiĂșsculas e minĂșsculas, nĂșmeros e os sĂ­mbolos de hĂ­fen (-) e sublinhado...Ver mais
status
string
Status atual da ação.
created: A ação foi criada com sucesso.
Erros

400Erro

empty_required_header

O header 'X-Idempotency-Key' é requerido e não foi enviado. Faça a requisição novamente incluindo-o.

required_properties

Certas propriedades obrigatĂłrias estĂŁo ausentes. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.

unsupported_properties

Foi enviada uma propriedade que nĂŁo Ă© suportada. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.

property_type

Um tipo de propriedade incorreto foi enviado. Por exemplo, um valor 'integer' para uma propriedade 'string'. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.

property_value

Um valor invĂĄlido foi enviado para alguma propriedade. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.

content is required

O campo content não estå presente no corpo da solicitação.

The content file size exceeds the limit 1MB

O conteĂșdo do campo content excede o limite permitido de 1MB.

Error decoding base64, the provided base64 string is not valid.

A codificação da imagem em base64 estå incorreta.

401Erro.

unauthorized

O valor enviado como Access Token estå incorreto. Verifique e tente enviar a requisição novamente com o valor correto.

403Erro.

forbidden_checking_terminal_owner

O terminal Point não pertence ao usuårio que enviou a solicitação. Verifique se o valor enviado para "terminal_id" estå correto ou se o terminal estå vinculado à sua conta.

409Erro.

idempotency_key_already_used

O valor enviado como header de idempotĂȘncia jĂĄ foi utilizado em uma solicitação diferente em um perĂ­odo menor que 24 horas. Por favor, tente realizar a solicitação novamente enviando um novo valor.

already_queued_order_for_terminal

O terminal já tem uma order em espera. É necessário finalizar ou cancelar para enviar novas orders.

500Erro.

idempotency_validation_failed

Falha na validação. Tente enviar a solicitação novamente.

500

Erro genérico. Tente enviar a solicitação novamente.

Requisição
curl -X POST \
    'https://api.mercadopago.com/terminals/v1/actions'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "type": "print",
  "external_reference": "ext_ref_1234",
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB123456789",
      "subtype": "image"
    }
  },
  "content": "iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
}'
Resposta de exemplo
{
  "id": "8952c6cf-bbb4-482c-a9f2-ea5fecd3ecd2",
  "type": "print",
  "external_reference": "ext_ref_1234",
  "status": "created",
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB123456789",
      "subtype": "image"
    }
  }
}