Measure integration quality
Integration quality measurement is a certification process that ensures your implementation meets the security and quality requirements needed to offer the best experience with Mercado Pago for both the seller and the buyer.
Therefore, before going to production, we recommend that you complete this step. Below you will find the aspects analyzed in this measurement and how to use the tool to maintain a continuous improvement process.
The measurement process analyzes a set of fields associated with fundamental aspects that a Mercado Pago integration must have. You can see these evaluated attributes below:
| Aspects | Description |
| Buyer experience | To grow and maintain your user base, you must offer a good payment experience. The measurement suggestions guide you to achieve the best results. |
| Financial reconciliation | Consistent financial verification of transactions with Mercado Pago maintains data integrity in your system. It is important to implement the measures and best practices indicated in the result. |
| Payment approval | For a good approval rate, validate the fields flagged as required improvements and implement the best practices. This provides more information to our fraud prevention tools for a more detailed assessment. |
| Scalability | Make sure to use the latest versions of our APIs and official libraries to get the best results. |
| Security | We aim to ensure the confidentiality of the data involved in the purchase. The improvements and best practices indicated in the result allow you to obtain and use the data securely. |
To perform the measurement, you need to declare your integration data. To do this, follow the instructions below:
- Locate your application configured with QR Code via Orders and, from the ">" button, select it.
- Under Integration stages, go to Test your integration > Declare integration information.
- Declare the requested information:
- How the integration will operate: state the brands you will use, the countries where operations will be carried out, and the Mercado Pago accounts used.
- Other integrated functionalities: state any additional features you are integrating with your product, such as applying discounts.
Once you have completed the declaration with your integration information, you can perform the quality measurement in two ways: manual or automatic.
If you prefer, you can perform a manual evaluation of your integration whenever you have an Order ID from a test payment that includes a completed payment. This is useful for new integrations that want to test their implementation before going to production and validate that it meets the required quality and security requirements.
To manually measure the quality of your integration in the test environment, go back to Integration data for the application and follow the steps below:
- Select Test your integration and click Start.
- In the Measure the quality of your integration step, click Start measurement.
- Enter the Order ID of the test payment. It must correspond to a payment made within the last 7 days with test credentials. Then click Measure quality.
- Once the Order ID has been evaluated, you will see the quality measurement result. The result can be:
| Result | Explanation |
| Below ideal | Your integration requires necessary actions to meet the expected quality. |
| Close to ideal | Your integration meets the requirements but can still improve. |
| Ideal | Your integration meets all expected requirements. |
- Click Go to details to see the quality of your integration. In this panel you will find the evaluation result with the information broken down into requirements, recommendations, and best practices so you can identify what to adjust and, if necessary, apply changes and run the measurement again.
In this way, you will have completed the quality measurement manually. To continue your integration process and go to production, click the Next button to access your production credentials.
Whether you have performed a manual quality measurement or received the results of your automatic evaluation, in Application details, in the Evaluation section of the Your integrations menu, you will find the following information:
- Score: indicates how aligned your integration is with Mercado Pago integration best practices. Reaching the minimum score of 73 does not by itself guarantee homologation approval: the score reflects integration quality, but you must also meet all mandatory evaluation fields. We recommend achieving 100 points to improve the user experience and increase the payment approval rate.
- Last measurement date and Order ID: indicates the day and time of the last measurement and the Order ID on which the application's quality score is based.
- Evaluated aspects: indicates the score obtained for each of the evaluated aspects. Select each one to see what improvement opportunities were identified in the process and how to address them. You can also filter by requirements, recommendations, and best practices. See the section How to improve the quality of your integration? for more optimization options.
- Measure again: once you have applied the improvement opportunities, you can measure the quality of your integration again manually or, if you prefer, wait for the monthly automatic measurement performed by Mercado Pago.
As a result of the quality measurement of your integration, our tool will point out different items that will allow you to optimize its performance and improve the experience for both the seller and the buyer.
These actions can be:
- Mandatory actions: requirements you must meet to ensure integration quality and improve your score. For example, enabling Webhooks notifications or sending an external reference that allows correlating payments between Mercado Pago and your system.
- Recommended actions: tasks that improve the score but do not prevent you from certifying the integration. For example, correctly itemizing the purchase line items within the order to improve the quality of the transaction information.
- Best practices: recommendations that do not affect the score but improve aspects of your integration. For example, implementing an operations manual so cashiers have clear instructions on how to use the point-of-sale software, or keeping your system up to date according to the events received via notifications.
Actions and best practices depend on each integration. Although information is provided here for QR Code via Orders, you should be guided by the information returned by the tool in the quality measurement result to optimize the operation of your integration and your score.