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 Suas integrações and select the application configured with Checkout Pro via Orders API.
- Go to Dados da integração . Under Informações gerais , proceed to Testar a integração . Then complete Informar dados sobre a integração .
- Under Informe como a integração funcionará , 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 Informe outras funcionalidades integradas (opcional) , select the integration types and security options incorporated. Then click Continuar.
- Under Revise os dados antes de salvar , verify the declared information. Then click Salvar .
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 Testar a integração and click Começar .
-
Under Medir a qualidade da sua integração , click Iniciar medição .
- 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. |
- Click Ir para o detalhe 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 Qualidade da integração section of Dados da integração , 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 novamente : 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.