post cover image

Changes in merchant_order notifications for attended QR Code model

Mercado Pago is continually evolving, and to optimize our processes, we will be introducing some changes regarding the creation of a Merchant Order for attended QR Code integrations starting August 27th.

Currently, the creation of the Merchant Order for this type of integration happens when the QR code is scanned by the customer. This creation triggers a notification from the merchant_order topic, with the status being "opened".

From the specified date, and with internal improvements made to our workflows, the Merchant Order creation will not necessarily happen at the time of scanning the QR code, but will depend on the integrated features and how the attended model is utilized instead. For this reason, the notification of the Merchant Order's opening may arrive at any other moment in the payment flow and will no longer be a valid indicator of scanning the QR code.

On the other hand, the order closing flow will remain as it is now. That is, you will receive a notification from the merchant_order topic with the status "closed" each time a payment is made.

With this in mind, we recommend that you modify your integration if it currently includes the merchant_order notification with the status "open" as a criterion for reading a QR code. Instead, begin to use only the notification with the "closed" status as a parameter, which indicates the closing of the order. This way, you will be able to verify the status of the completed payment and proceed to print the ticket, as shown in the new explanatory flow available in the documentation.

Although this change will take effect on August 27th, 2024, you can start making the necessary adjustments in your system right now. If you have any questions, take advantage of the time you have left to contact us and resolve them.