Para iniciar el proceso de configuración, es necesario tener una cuenta empresa en Mercado Pago, que te permitirá crear una aplicación en Mercado Pago Developers.

Para crear tu cuenta empresa, ingresa a nuestra página de registro y completa los datos solicitados con la información de la billetera digital que representas.

Luego, ingresa a Mercado Pago Developers, inicia sesión con la cuenta empresa correspondiente a la billetera, y accede a Tus integraciones en la esquina superior derecha de la pantalla.

En la pantalla siguiente, haz clic en el botón Crear aplicación.

Esto te redireccionará a la pantalla Configuraciones básicas, donde deberás completar la información solicitada tal como señalamos a continuación:

• Nombre de la aplicación: elige un nombre para la aplicación, asociado con la billetera para la que la estás creando. Tienes un límite de 50 caracteres.
• Como solución de pago a integrar, elige la opción Pagos presenciales.
• En la pregunta por el producto a integrar, selecciona la opción CódigoQR.
• No es necesario que selecciones el modelo de integración.

Por último, marca la casilla para autorizar el uso de tus datos personales de acuerdo con la Declaración de Privacidad y certificar que tu cuenta utiliza las herramientas de Mercado Pago de acuerdo con los Términos y Condiciones, así como la casilla de selección No soy un robot, y haz clic en Crear aplicación.

Esto generará automáticamente una tarjeta en Tus integraciones con el nombre y el número de la aplicación, que te permitirá acceder a sus detalles cuando sea necesario.

Para continuar con la configuración del QR interoperable, es necesario que la billetera digital solicite el alta y su incorporación a Mercado Pago.

Para ello, debes comunicarte con nuestro Centro de Soporte y solicitar que requieres apoyo para la configuración del flujo aceptador de QR interoperable, proporcionando la siguiente información.

Con estos datos, nuestro equipo de Soporte gestionará la incorporación de la billetera y confirmará posteriormente su alta.

Para poder utilizar las APIs de Mercado Pago, es necesario obtener las credenciales a través del flujo OAuth. De esta manera, podrás crear un Access Token que te permitirá acceder a los recursos de la aplicación creada de manera segura.

Para obtenerlo, sigue los pasos a continuación.

1. Dentro de Tus integraciones, selecciona la aplicación creada para la billetera digital.
2. En el menú desplegado a la izquierda de la pantalla, selecciona la opción Credenciales de producción.
3. Localiza las credenciales Client ID y Client Secret, que deberás utilizar para generar el Access Token mediante el flujo OAuth, tal como se muestra en la siguiente imagen.

4. Envía un POST al endpoint /oauth/token con los parámetros obligatorios descritos a continuación para generar tu 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"
}'

En la respuesta a la solicitud obtendrás, entre otros parámetros, tu Access Token, que deberás utilizar en los llamados a las APIs de Mercado Pago.

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

Al configurar la interoperabilidad de los Códigos QR de Mercado Pago, es posible también configurar la recepción de notificaciones Webhooks para los pagos realizados.

Para hacerlo, sigue los pasos a continuación.

1. Accede a Tus integraciones y selecciona la aplicación creada para la billetera digital.
2. En el menú desplegado a la izquierda de la pantalla, selecciona la opción Notificaciones > Webhooks.
3. En la pestaña Modo producción, proporciona la URL que será utilizada para recibir las notificaciones.
4. En Eventos, elige la opción Pagos (interoperabilidad de tarjetas de crédito).

5. Haz clic en Guardar y confírmalo en la pantalla siguiente.

Antes de pasar a producción, ten en cuenta las siguientes consideraciones para garantizar el correcto funcionamiento de tu integración.

• Utiliza siempre el Access Token de la billetera creado a través del flujo de Client Credentials de OAuth. Asegúrate de renovarlo antes de las 6 horas.
• Asegúrate de ofrecer siempre una experiencia de usuario adecuada: brinda mensajes claros para optimizar la comprensión de cada escenario de pago, falla o error que ocurra al escanear los códigos QR utilizando la billetera.
• Recuerda incluir correctamente los patrones de códigos QR de Mercado Pago desde tu dominio. En la mayoría de los casos, esto debe hacerse con un dominio invertido, como com.mercadolibre, pero también es posible encontrar QRs no EMVCO, como https://mpago.la/pos/<id> o https://mpago.la/s/qr/<id1><id2>.
• Identifica las operaciones con códigos rastreables que permitan a COELSA reconocer las pertenecientes a Mercado Pago. Para esto, envía el order.id de la IEP de Mercado Pago como qr_trx_id a la API de COELSA.