To start the setup process, you need to have a business account in Mercado Pago, which will allow you to create an application in Mercado Pago Developers.

To create your business account, go to our registration page and fill in the requested data with the information of the digital wallet you represent.

Then, go to Mercado Pago Developers, sign in with the business account corresponding to the wallet, and access Your integrations in the upper right corner of the screen.

On the next screen, click the Create application button.

This will redirect you to the Basic settings screen, where you must fill in the requested information as indicated below:

• Application name: choose a name for the application, associated with the wallet for which you are creating it. You have a limit of 50 characters.
• As the payment solution to integrate, choose the In-person payments option.
• For the product to integrate, select the QR Code option.
• It is not necessary to select the integration model.

Finally, check the box to authorize the use of your personal data in accordance with the Privacy Statement and certify that your account uses Mercado Pago tools in accordance with the Terms and Conditions, as well as the I am not a robot checkbox, and click Create application.

This will automatically generate a card in Your integrations with the name and number of the application, which will allow you to access its details when necessary.

To continue with the QR interoperability setup, the digital wallet must request its onboarding into Mercado Pago.

To do so, contact our Support Center and request support for the QR interoperability acceptor flow configuration, providing the following information.

With this data, our Support team will manage the wallet onboarding and subsequently confirm its activation.

To use Mercado Pago APIs, you need to obtain credentials through the OAuth flow. This way, you can create an Access Token that will allow you to securely access the resources of the created application.

To obtain it, follow the steps below.

1. Within Your integrations, select the application created for the digital wallet.
2. In the menu on the left side of the screen, select the Production credentials option.
3. Locate the Client ID and Client Secret credentials, which you must use to generate the Access Token through the OAuth flow, as shown in the following image.

4. Send a POST to the /oauth/token endpoint with the required parameters described below to generate your Access Token.

curl
Copiar
curl --location 'https://api.mercadopago.com/oauth/token' \
--header 'Content-Type: application/json' \
--data '{
 "client_id": "{CLIENT_ID}",
 "client_secret": "{CLIENT_SECRET}",
 "grant_type": "client_credentials"
}'

In the response you will receive, among other parameters, your Access Token, which you must use in calls to Mercado Pago APIs.

json
Copiar
{
  "access_token": "{ACCESS_TOKEN}",
  "token_type": "Bearer",
  "expires_in": 21600,
  "scope": "offline_access read write",
  "user_id": "{USER_ID}",
  "live_mode": true
}

When setting up Mercado Pago QR Code interoperability, you can also configure the receipt of Webhook notifications for payments made.

To do so, follow the steps below.

1. Access Your integrations and select the application created for the digital wallet.
2. In the menu on the left side of the screen, select the Notifications > Webhooks option.
3. In the Production mode tab, provide the URL that will be used to receive notifications.
4. In Events, choose the Payments (credit card interoperability) option.

5. Click Save and confirm on the next screen.

Before going to production, keep in mind the following considerations to ensure your integration works correctly.

• Always use the wallet's Access Token created through the Client Credentials OAuth flow. Make sure to renew it before 6 hours.
• Always ensure an appropriate user experience: provide clear messages to optimize understanding of each payment, failure, or error scenario when scanning QR codes with the wallet.
• Remember to correctly include Mercado Pago QR code patterns from your domain. In most cases, this should be done with an inverted domain, like com.mercadolibre, but non-EMVCO QRs are also possible, such as https://mpago.la/pos/<id> or https://mpago.la/s/qr/<id1><id2>.
• Identify operations with traceable codes that allow COELSA to recognize those belonging to Mercado Pago. To do this, send the order.id from Mercado Pago's IEP as qr_trx_id to the COELSA API.