If your current integration is through the API, Mercado Pago offers the possibility to integrate in-person payments through the Order API, designed to simplify the integration of Mercado Pago's payment products.

To ensure a successful migration to the Order API, you must meet the following prerequisites:

The Order API provides various endpoints that allow you to perform the same functionalities more efficiently:

• Get terminals: This endpoint allows you to obtain a list of the Point terminals associated with your Mercado Pago account. It will provide you with their respective ID and the operating mode in which they are functioning.
• Update terminal operation mode: If the terminal you are trying to integrate is in STANDALONE operational mode, you will need to update it to POS mode using this endpoint. This will allow you to operate in integrated mode with our API.
• Create order: This endpoint allows you to create an order that contains payment transactions for Mercado Pago Point. You can associate it with the desired terminal using its ID.
• Get order by ID: This allows you to retrieve all the information about an order using the ID obtained in the response to its creation.
• Cancel order by ID: This allows you to cancel an order created for Mercado Pago Point using the reference ID obtained in the response to its creation.
• Refund order: This endpoint allows to create a refund for payment transactions associated with an order for Mercado Pago Point.

The Printings API offers a practical solution to integrate your systems and manage printings on configured Point terminals. This resource allows the printing of receipts, electronic tax documents (DTE), images, and customized printings directly from a point of sale (POS), using the integrated printer of Smart devices. This simplifies the billing process and quickly responds to the needs of your business.

The following types of Documentos Tributarios Electrónicos (DTE) in XML format are accepted:

Use the endpoints below to manage the print queue, taking into account the specifications of each endpoint. Ensure that the terminal is configured in POS (Point of Sale) mode.

The available endpoints are:

• Create terminal action: Allows the creation of a new printing action for Mercado Pago Point, either images or custom printings. If successful, the response will return a 201 status code.
• Get action by ID: Allows retrieving all information of an action created for a Point terminal using the ID obtained in the response upon its creation. Querying the printing action provides a practical tool to verify the action sent by the API, especially in case of printing failures on the terminal.
• Cancel action by ID: Allows you to cancel an action created for Mercado Pago Point and its transactions using the reference ID obtained in the response to its creation. Only an action in "created" status can be canceled. In case of success, the request will return a response with status 200.

Wait until the printing intent reaches the terminal and the print is processed. If the print does not arrive automatically, press the Update button to fetch the intent manually.

Custom tags allow you to adjust the format and appearance of printed documents, ensuring greater control over the style and structure of the text. They must be used when sending a POST to the Create terminal action endpoint, through the subtype attribute, which must be set as custom. When subtype is defined as custom, the content attribute must include the formatted string using the supported tags.

Below, check out the different available tags, their functions, and examples of usage:

Example:

plain
Copiar
{
  "type": "print",
  "config": {
    "point": {
      "terminal_id": "{{device.id}}",
      "subtype": "custom"
    }
  },
  "external_reference": "8a42e06e45d5",
  "content": "{br}--------------------------------{br}{center}{w} DELIVERY RECEIPT{/w}{br}{br}{s} Order No:12345{/s}{br}{s} Store: Test Store{/s}{br}--------------------------------{br}{s}***DISPATCHED ITEM(S)***{/s}{br}{s}SKU / ITEM                       QUANTITY   {/s}{br}{s}----------------------------------------------{/s}{br}{s}4065432630504 / FOOTBALL WUCL LGE EHV240424   1{br}{s}DELIVER ON: 06/06/2024{/s}{br}{s}ADDRESS: METROPOLITANA  {/s}{br}{s}RECEIVER: John{/s}{br}{s}delivery to client in the morning{/s}{br}--------------------------------{br}"
}