How to measure the integration quality - Checkout Bricks - Mercado Pago Developers

Integration quality

In order to offer both the seller and the buyer the best experience, it is important to validate your integration quality according to the Mercado Pago standards before going to production. You will find all the necessary information you need to homologate your integration below.

What is homologation?

The homologation is a process by wich you can certify your integration and make sure that your development is within the quality requirements to offer both the customer and the seller the best experience with Mercado Pago.

What aspects does the homologation assess?

The homologation process analizes a series of fields associated with 5 fundamental aspects that must be taken into consideration in a Mercado Pago integration. You can see the assessed attributes and the importance of each of them below.

Payments ApprovalIn order to guarantee a good payment approval rate, it is important to validate each one of the fields marked as necessary improvements, as well as to implement the suggested good practices in your homologation results. By doing so, you will provide our fraude prevention tools the information to make a more detailed assessment.
User ExperienceIf you want to grow and maintain the user rate in your integration, you must be able to offer a good payment experience. The Mercado Pago suggestions, given as a result of your homologation, will help you obtain the bests results.
SecurityIn Mercado Pago we seek to ensure the confidenciality of the data involved in the purchase process. The improvements and good practices given as a result of your homologation will allow you to obtain the necessary data in a secure and reliable way.
ScalabilityWhen you do homologate your integration, you must make sure to be using the updated version of our APIs and official libraries, wich will assure you the bests results.
Financial ConciliationWith the consistency of the financial verification in the transactions registered with Mercado Pago we intend to maintain the integrity of your system data. That’s why it is important to implement the necessary measures and the good practices suggested as a result of your homologation.

How to homologate my integration?

For now, the integration quality measuring tool is only available for integrations with Checkout Pro, Checkout API , Checkout Bricks and Mercado Pago Point .

To measure the quality of your application, follow the steps below.

  1. In the Devsite, click on Your integrations menu.
  2. In the Developer dashboard

, click on the desired application. It must be an application in which you have integrated a product admitted by the homologation tool (Checkout Pro, Checkout Bricks, Checkout API , or Mercado Pago Point). 3. Then click on Update score to access the tool where you can measure the quality of your application and view the score that indicates how secure and aligned your application configuration is with the good practices of Mercado Pago integration. 4. On the Integration Quality screen, click Update score and enter the payment ID of a recent payment made with production credentials of the application you wish to homologate. Whenever possible, use the last productive payment ID identified in the application in question.

Ready! The quality measurement has been performed. Now, you can learn your score and which are the aspects you can improve of your homologation.

How to read your homologation's results?

Once you’ve measured your integration’s quality, you will find the next screen:


  1. Score: indicates how safe your application's configuration is and is in line with Mercado Pago's best integration practices. The minimum score to fullfill the requirements is 75. Either way, remember that as close as your score is to a 100, it would improve the user experience and your payment approval rates.
  2. Payment ID and Last update: payment ID on which the application quality score is based and date of last update of the application's quality score.
  3. Pending improvements: indicates which are the improvement opportunities identified in the process, and how to fix them. Click on them to see the details.
Actions indicated as required must be completed to add points that will improve the quality of your integration, while those indicated as best practices are recommended but will not impact the score.
  1. Update score: Once you make all the necessary changes, you can mesure your integration’s quality again, before going to production.