Si tu integración actual es mediante API, Mercado Pago ofrece la posibilidad de integrar pagos presenciales a través de la API de Order, diseñada para simplificar la integración de los productos de pago de Mercado Pago.

Para garantizar una migración exitosa a la API de Order, debes cumplir con los siguientes requisitos previos:

La API de Order proporciona diversos endpoints que permiten ejecutar las mismas funcionalidades de manera más eficiente:

• Obtener terminals: Este endpoint permite obtener un listado de las terminals Point asociadas a tu cuenta de Mercado Pago. Te indicará su respectivo ID y el modo de operación en el que está funcionando.
• Actualizar modo de operación de la terminal: En caso de que la terminal con la que estés queriendo integrar esté en modo operativo STANDALONE, deberás actualizarlo a PDV utilizando este endpoint. De esa manera, podrás operar en modo integrado con nuestra API.
• Crear order: Este endpoint permite crear una order que contenga transacciones de pago para Mercado Pago Point. Podrás asociarla a la terminal deseada mediante su ID.
• Obtener order por ID: Permite consultar toda la información sobre una order utilizando el ID obtenido en la respuesta a su creación.
• Cancelar order por ID: Permite cancelar una order creada para Mercado Pago Point utilizando el ID de referencia obtenido en la respuesta a su creación.
• Reembolsar una order: Permite crear una devolución total de una transacción de pago asociada a una order para Mercado Pago Point.

La API de Impresiones ofrece una solución práctica para integrar tus sistemas y gestionar impresiones en las terminales Point configuradas. Este recurso permite la impresión de recibos, facturas electrónicas (DTE), imágenes e impresiones personalizadas directamente desde un punto de venta (PDV), utilizando la impresora integrada de los dispositivos Smart. Esto simplifica el proceso de cobro y responde rápidamente a las necesidades de tu negocio.

Para la impresión de DTEs, se admiten los siguientes tipos de Documentos Tributarios Electrónicos (DTE) en formato XML:

Utiliza los endpoints que compartimos a continuación para gestionar la cola de impresiones, teniendo en cuenta las especificaciones de cada endpoint. Asegúrate de que la terminal esté configurada en modo PDV (Punto de Venta).

Los endpoints disponibles son:

• Crear acción de la terminal: Permite la creación de una nueva acción de impresión para Mercado Pago Point, ya sea de imágenes o impresiones personalizadas. En caso de éxito, la respuesta devolverá un código de estado 201.
• Obtener acción por ID: Permite consultar toda la información de una acción creada para un terminal Point utilizando el ID obtenido en la respuesta a su creación. La consulta de la acción de impresión proporciona una herramienta práctica para verificar la acción enviada por la API, especialmente en caso de fallos de impresión en el terminal.
• Cancelar acción por ID: Permite una acción creada para Mercado Pago Point y sus transacciones utilizando el ID de referencia obtenido en la respuesta a su creación. Sólo puede ser cancelada una acción en status "created". En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

Aguarda hasta que el intento llegue a la terminal y se procese la impresión. Si la impresión no llega automáticamente, presiona el botón Actualizar para buscar el intento manualmente.

Las tags personalizadas permiten ajustar el formato y la apariencia de los documentos impresos, garantizando un mayor control sobre el estilo y la estructura del texto. Deben utilizarse al enviar un POST al endpoint Crear acción del terminal, a través del atributo subtype, que debe configurarse como custom. Cuando el subtype se define como custom, el atributo content debe incluir la string formateada utilizando las tags soportadas.

A continuación, consulte las diferentes tags disponibles, sus funciones y ejemplos de uso:

Ejemplo de uso:

plain
Copiar
{
  "type": "print",
  "config": {
    "point": {
      "terminal_id": "{{device.id}}",
      "subtype": "custom"
    }
  },
  "external_reference": "8a42e06e45d5",
  "content": "{br}--------------------------------{br}{center}{w} COMPROBANTE DE ENTREGA{/w}{br}{br}{s} Nro pedido :12345{/s}{br}{s} Tienda: Tienda de prueba{/s}{br}--------------------------------{br}{s}***ITEM(S) DESPACHO***{/s}{br}{s}SKU / ARTICULO                    CANTIDAD    {/s}{br}{s}----------------------------------------------{/s}{br}{s}4065432630504 / BALON FUTBOL WUCL LGE EHV240424   1{br}{s}ENTREGAR: 06/06/2024{/s}{br}{s}DIRECCION: METROPOLITANA  {/s}{br}{s}RECIBE: John{/s}{br}{s}entrega a cliente en horario am{/s}{br}--------------------------------{br}"
}