Measure integration quality
Quality measurement evaluates whether your integration meets Mercado Pago's security and quality requirements. Before going to production, complete this evaluation to identify mandatory adjustments, recommendations, and best practices.
During the measurement, Mercado Pago analyzes the following aspects of the integration:
| Aspect | Description |
| Buyer experience | Evaluates the data and settings that affect the payment experience. |
| Financial reconciliation | Verifies that the integration facilitates correlating Mercado Pago payments with the operations recorded in your system. |
| Payment approval | Analyzes the information submitted with each payment to improve the approval rate and apply fraud prevention tools. |
| Scalability | Verifies the use of updated official libraries and that the integration can sustain and diagnose operations over time. |
| Security | Evaluates the secure handling of credentials and the data used during the purchase. |
To perform the measurement, first provide your integration data.
- Go to Integrations and select the application configured with Checkout Pro via Orders API.
- From the side menu, select Integration quality. If you have not yet provided the data required for the measurement, click Provide data.
- Under Edit data, complete the requested information about how your integration will operate and its integrated features.
- Click Save.
After saving the information, you can perform the quality measurement manually or automatically.
To manually measure integration quality, use the Order ID of a test payment made within the last 7 days:
-
From the application's side menu, select Integration quality.
-
Click Start measurement. If the application already has a result, click Measure again.
-
Enter the Order ID of a test payment made with test credentialsAccess keys linked to your application that allow you to simulate payments and validate the integration without processing real transactions.. Then click Medir qualidade .
- Review the measurement result.
| Result | Explanation |
| Below ideal | Your integration requires mandatory 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. |
The result is displayed in Integration quality, together with the identified requirements, recommendations, and best practices. You can also access it from Home: in the View the quality measurement result stage, click Go to details.
After completing the measurement, apply all mandatory actions indicated by the tool and measure the integration quality again to verify the adjustments.
Whether you have performed a manual measurement or received the results of an automatic measurement, you will find the following information:
- Score and status: indicate the level of compliance with the quality criteria and whether the result is below ideal, close to ideal, or ideal.
- Last measurement date and Order ID: identify when the last evaluation was performed and which payment was used.
- Result summary: shows how many mandatory requirements and recommendations are pending, along with the best practices you can apply.
- Evaluation details: let you review mandatory requirements, recommendations, and best practices. You can also filter the results by aspects such as purchase experience, payment approval, security, scalability, and financial reconciliation.
- Edit data: lets you update the information provided about the integration.
- Measure again: lets you repeat the measurement after applying the identified adjustments.
For your integration to meet the quality criteria, resolve all mandatory actions indicated by the tool.
The result groups improvement opportunities into the following categories:
- Mandatory actions: requirements you must meet to ensure integration quality. For example, configuring Webhook notifications or submitting an external reference to correlate payments.
- Recommended actions: adjustments that improve the score. For example, submitting complete buyer information to support payment analysis.
- Best practices: recommendations that do not change the score but improve integration maintenance.
Apply the specific instructions returned by the tool and run a new measurement to verify the changes.