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:
| Requisito | Descrição |
| Conta de vendedor do Mercado Pago | Para 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ções | As 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. |
| Credenciais | As 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 Pago | Para 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 Pago | Alé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:
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 conectar seus sistemas e realizar a gestão de impressão de faturas e comprovantes, assim como impressões personalizadas, nos terminais Point que você tiver configurados. Com essa API, é possível garantir uma experiência de cobrança unificada e eficiente.
Este recurso permite a impressão de recibos e faturas eletrônicas (DTE) e impressões personalizadas diretamente de um ponto de venda (PDV) através da API, 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:
| Tipo de documento | Descriçã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. |
Tags personalizadas
As tags personalizadas permitem ajustar a apresentação dos documentos impressos. Elas oferecem flexibilidade e controle sobre o formato do texto, possibilitando a criação de impressões eficientes e visualmente atraentes. A seguir, consulte as diferentes tags disponíveis, suas funções e exemplos de uso:
| Tag | Função | Exemplo |
{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 o código de barras de um TED | {pdf417}Texto{/pdf417} |
Configuração da impressão
Utilize a API para gerenciar o enfileiramento de impressões, considerando as especificações de cada endpoint.
Os endpoints diponíveis são:
- Criar ação do terminal: Este endpoint permite que você crie uma nova ação de terminal para Mercado Pago Point.
- Obter ação por ID: Este endpoint permite que você consulte todas as informações da ação utilizando o ID obtido na resposta à sua criação.
- Cancelar ação por ID: Este endpoint permite cancelar uma order 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.
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.