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.

Pagamentos online
Pagamentos presenciais
Ferramentas e recursos
APIs e SDKs
Order (integração via API) - Como migrar ao ecossistema Mercado Pago - Mercado Pago Developers

Order (Integração via API)

Se sua integração atual é por meio da API, o Mercado Pago oferece a possibilidade de integrar pagamentos presenciais por meio da API de Order, desenhada para simplificar a integração dos produtos de pagamento do Mercado Pago.

Pré-requisitos

Para garantir uma migração bem-sucedida para a API de Order, você deve cumprir os seguintes requisitos prévios:

RequisitoDescrição
Conta de vendedor do Mercado PagoPara realizar uma integração com o Mercado Pago, você precisa ter uma conta de vendedor. Se ainda não a possui, acesse a página para criá-la gratuitamente.
Aplicação criada em Suas integraçõesAs aplicações são as diferentes integrações contidas em uma ou várias lojas. Você pode criar uma aplicação para cada solução que implementar, a fim de manter tudo organizado e ter um controle que facilite a gestão. Além disso, ao criar uma aplicação, você poderá obter as credenciais necessárias para operar. Para criar sua aplicação, consulte a documentação do Painel do desenvolvedor.
CredenciaisAs credenciais são chaves únicas fornecidas quando você cria a aplicação em Suas integrações. Você precisará de um par de credenciais de produção para receber pagamentos reais. Consulte Credenciais para mais informações.
Terminal Point do Mercado PagoPara integrar-se ao Mercado Pago, é necessário que você tenha um terminal Point. Para obtê-lo, entre em contato com seu executivo comercial de carteira assessorada.
Aplicação do Mercado PagoAlém do terminal, é necessário ter o aplicativo Mercado Pago para fazer login e gerenciar os pagamentos realizados. Você pode baixá-lo tanto para dispositivos Android quanto para iOS.

Configuração da integração

A API de Order fornece diversos endpoints que permitem executar as mesmas funcionalidades de maneira eficiente:

Importante
Para utilizar esses endpoints, é necessário que seu terminal esteja configurado no modo PDV. Se estiver configurado no modo STANDALONE, entenderemos que você deseja processar pagamentos de forma não integrada, o que impedirá o uso da nossa API. Para configurar seu terminal no modo PDV, utilize o endpoint Atualizar o modo de operação do terminal, que permite modificar o modo de operação dos terminals.
  • Obter terminals: Este endpoint permite obter uma lista dos terminals Point associados à sua conta do Mercado Pago. Ele indicará seu respectivo ID e o modo de operação em que está funcionando.
  • Atualizar o modo de operação do terminal: Caso o terminal com o qual você esteja tentando integrar esteja no modo operacional STANDALONE, será necessário atualizá-lo para o modo PDV utilizando este endpoint. Assim, você poderá operar de forma integrada com nossa API.
  • Criar order: Este endpoint permite criar uma order que contenha transações de pagamento para o Mercado Pago Point. Você poderá associá-lo ao terminal desejado por meio do seu ID.
  • Obter order por ID: Permite consultar todas as informações sobre uma order utilizando o ID obtido na resposta à sua criação.
  • Cancelar order por ID: Permite cancelar uma order criada para o Mercado Pago Point utilizando o ID de referência obtido na resposta à sua criação.
  • Reembolsar uma order: Permite criar uma devolução total de uma transação de pagamento associada a uma order para Mercado Pago Point.

Configuração de impressões

A API de Impressões oferece uma solução prática para integrar seus sistemas e gerenciar impressões nas terminais Point configuradas. Este recurso permite a impressão de recibos, documentos fiscais eletrônicos (DTE), imagens e impressões personalizadas diretamente de um ponto de venda (PDV), utilizando a impressora integrada dos dispositivos Smart. Isso simplifica o processo de cobrança e responde rapidamente às necessidades do seu negócio.

Impressão de faturas e recibos eletrônicos

São aceitos os seguintes tipos de Documentos Tributários Eletrônicos (DTE) em formato XML:

Importante
O DTE enviado deve ser compatível com os formatos definidos pelo SII.
Tipo de documentoDescrição
Fatura Afetada (33) e Isenta (34)Refere-se ao documento tributário que tem validade legal perante o Serviço de Impostos Internos (SII).
Recibo Afetado (39) e Isento (41)Refere-se ao documento que o cliente recebe ao realizar uma compra, tendo validade contábil e tributária.

Configuração da impressão

Utilize os endpoints abaixo para gerenciar a fila de impressões, levando em conta as especificações de cada endpoint. Certifique-se de que o terminal esteja configurado no modo PDV (Ponto de Venda).

Importante
Para a impressão de imagens, tenha em mente que os formatos aceitos são PNG ou JPEG, com codificação Base64 e um tamanho máximo de 1MB. As imagens que excederem as dimensões do rolo de papel serão ajustadas automaticamente.

Os endpoints disponíveis são:

  • Criar ação da terminal: Permite a criação de uma nova ação de impressão para Mercado Pago Point, seja de imagens ou impressões personalizadas. Em caso de sucesso, a resposta devolverá um código de status 201.
  • Obter ação por ID: Permite consultar todas as informações da ação de impressão criada para uma terminal Point através do ID obtido na resposta à sua criação. A consulta da ação de impressão fornece uma ferramenta prática para verificar a ação enviada pela API, especialmente no caso de falhas de impressão na terminal.
  • Cancelar ação por ID: Permite cancelar uma ação criada para Mercado Pago Point e suas transações utilizando o ID de referência obtido na resposta à sua criação. Apenas uma ação com status "created" pode ser cancelada. Em caso de sucesso, a solicitação devolverá uma resposta com status 200.

Aguarde até que a tentativa chegue ao terminal e a impressão seja processada. Se a impressão não chegar automaticamente, pressione no botão Atualizar para buscar a tentativa manualmente.

Tags personalizadas

As tags personalizadas permitem ajustar o formato e a aparência dos documentos impressos, garantindo maior controle sobre o estilo e a estrutura do texto. Elas devem ser utilizadas ao enviar um POST ao endpoint Criar ação do terminal, através do atributo subtype, que deve ser configurado como custom. Quando o subtype é definido como custom, o atributo content deve incluir a string formatada utilizando as tags suportadas.

A seguir, consulte as diferentes tags disponíveis, suas funções e exemplos de uso:

As tags personalizadas têm um limite mínimo de 100 caracteres e um máximo de 4096 caracteres, incluindo elas próprias.
TagFunçãoExemplo
{b}Negrito{b}Texto em negrito{/b}
{w}Letra grande{w}Texto em letra grande{/w}
{s}Letra pequena{s}Texto em letra pequena{/s}
{br}Quebra de linha{br}
{left}Alinhar à esquerda{left}Texto alinhado à esquerda{/left}
{center}Centralizar texto{center}Texto centralizado{/center}
{qr}Imprimir um QR que representa o texto enviado{qr}Texto{/qr}
{pdf417}Imprimir a mancha de um TED{pdf417}Texto{/pdf417}

Exemplo de utilização:

plain

{
  "type": "print",
  "config": {
    "point": {
      "terminal_id": "{{device.id}}",
      "subtype": "custom"
    }
  },
  "external_reference": "8a42e06e45d5",
  "content": "{br}--------------------------------{br}{center}{w} COMPROVANTE DE ENTREGA{/w}{br}{br}{s} Nro pedido :12345{/s}{br}{s} Loja: Loja de teste{/s}{br}--------------------------------{br}{s}***ITEM(S) DESPACHO***{/s}{br}{s}SKU / ARTIGO                     QUANTIDADE   {/s}{br}{s}----------------------------------------------{/s}{br}{s}4065432630504 / BOLA FUTEBOL WUCL LGE EHV240424   1{br}{s}ENTREGAR: 06/06/2024{/s}{br}{s}ENDEREÇO: METROPOLITANA  {/s}{br}{s}RECEBE: John{/s}{br}{s}entrega ao cliente no período da manhã{/s}{br}--------------------------------{br}"
}