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, you need to declare your integration data. To do this, follow the instructions below:
- Go to Tus integraciones and select the application configured with Checkout Pro via Orders API.
- Go to Datos de integración. Under Información general, proceed to Probar la integración. Then complete Declarar información sobre la integración.
- Under Declara cómo operará la integración, indicate how many brands will use the integration, in how many countries operations will be carried out, and how many Mercado Pago accounts will be used. Then click Continuar.
- Under Declara otras funcionalidades integradas (opcional), select the integration types and security options incorporated. Then click Continuar.
- Under Revisa los datos antes de guardar, verify the declared information. Then click Guardar.
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:
-
Select Probar la integración and click Comenzar.
-
Under Medir la calidad de tu integración, click Iniciar medición.
- 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 calidad.
- 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. |
- Click Ir al detalle to review the identified requirements, recommendations, and best practices.
After completing the measurement, apply all mandatory actions indicated by the tool and measure the integration quality again to verify the adjustments.
In the Calidad de integración section of Datos de integración, you will find the following information:
- Score: indicates the level of compliance with the quality criteria. The minimum expected score is 73 points, but reaching it is not sufficient by itself: you must also resolve all mandatory actions. We recommend reaching 100 points.
- Last measurement date and Order ID: identifies when the last evaluation was performed and which payment was used.
- Evaluated aspects: shows the score for each aspect and allows you to filter the results by requirements, recommendations, and best practices.
- Medir de nuevo: allows you to repeat the measurement after applying the identified adjustments.
Analyze the score together with the 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.