Estamos evolucionando nuestra forma de integrar. Descubre la nueva API Orders

Requisitos previos - Código QR - Mercado Pago Developers

Requisitos previos

Ten en cuenta estos aspectos antes de empezar:

  1. Acceder a una cuenta
  2. Crear una aplicación
  3. Acceder a las credenciales de prueba
  4. Obtener tu Access Token (OAuth)
  5. Identificar tu integración (Sponsor ID)

1. Acceder a una cuenta

Para poder comenzar la integración, es necesario contar con una cuenta de Mercado Pago o Mercado Libre.

Puedes ingresar a una cuenta existente o Crear una cuenta nueva.

2. Crear una aplicación

Las aplicaciones son entidades registradas dentro de Mercado Pago que actúan como un identificador único para gestionar la autenticación y autorización de tus integraciones. Es decir, son el vínculo entre tu desarrollo y Mercado Pago, y constituyen la primera etapa para realizar la integración.

Con ellas, es posible acceder a las credencialesClaves de acceso únicas con las que identificamos una integración en tu cuenta, vinculadas a tu aplicación. Para más información, accede al link a continuación.Credenciales necesarias para interactuar con nuestras APIs o servicios específicos, así como gestionar y organizar tu integración, por lo que deberás crear una aplicación por cada solución de Mercado Pago que integres.

Para crear una aplicación, sigue los pasos a continuación.

  1. En la esquina superior derecha de Mercado Pago Developers, haz clic en Ingresar e ingresa los datos requeridos con la información correspondiente a tu cuenta de Mercado Pago.
  2. Con la sesión iniciada, en la esquina superior derecha de Mercado Pago Developers, haz clic en Crear aplicación si tu cuenta aún no tiene ninguna aplicación creada, o accede a "Tus integraciones" y selecciona Ver todas. Allí, haz clic en Crear aplicación.
  3. Una vez dentro de Tus integraciones, haz clic en el botón Crear aplicación.
Para proteger tu cuenta, durante la creación de una aplicación será necesario que realices una verificación de identidad, en caso de que aún no la hayas realizado, o una reautenticación, si ya has completado previamente el proceso de verificación.

create-application-1

  1. Ingresa un nombre para identificar tu aplicación. El límite es de hasta 50 caracteres alfanuméricos.
Nota
En caso de que la caja integrada tenga varias conexiones con cuentas Mercado Pago, dirígete a los puntos 4 y 5 dentro de esta misma sección. Presta atención a la seguridad de tu integración e implementa Oauth.

3. Acceder a las credenciales de prueba

Después de crear tu aplicación, automáticamente también se crearán las credenciales de pruebaClaves de acceso únicas con las que identificamos una integración en tu cuenta, vinculadas a tu aplicación. Para más información, accede al link a continuación.Credenciales. Utiliza las credenciales de prueba para realizar todas las configuraciones y validaciones necesarias en un entorno seguro de pruebas.

Al acceder a las credenciales de prueba, se mostrarán los siguientes pares de credenciales: Public KeyClave pública que es utilizada en el frontend para acceder a información y cifrar datos. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. y el Access TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. de prueba.

credenciales de test

Si estás utilizando una aplicación ya existente, será necesario activar las credenciales de prueba. Para más información, consulta la documentación de Credenciales.

4. Obtener tu Access Token (OAuth)

Si eres un integrador que trabajará con varios comercios para que operen con Mercado Pago, te recomendamos realizar el proceso OAuth - autenticación entre cuentas. Este proceso consiste en que el cliente permita que sus datos sean compartidos con un sistema de terceros de forma segura.

El Access Token se podrá compartir solamente mediante OAuth. Consulta la documentación para obtener más información.

5. Identificar tu integración (Sponsor ID)

Cuando una cuenta Mercado Pago es creada, se le asigna un User ID, en caso de ser usuarios, o un Cust ID, en caso de ser vendedor. Ambas son identificaciones únicas que se generan automáticamente, y que permitirán asociar las integraciones a cada cuenta al incluirlos en los llamados a la API.

Cuando realizas integraciones para terceros, el parámetro sponsor_id te permitirá identificar las órdenes que son realizadas por tu punto de venta. Deberás enviar el Sponsor ID en los llamados a la API de órdenes presenciales. Sigue las instrucciones a continuación para saber cómo obtenerlo e incluirlo:

  1. Si todavía no lo has hecho, crea una cuenta Mercado Pago Developers.
  2. Obtén la identificación del usuario (Cust ID o User ID) de tu cuenta accediento a los detalles de la aplicación que creaste anteriormente.
  3. Incluye el ID de tu cuenta de integrador dentro del Sponsor ID del vendedor.
  4. Envía el Sponsor ID en todas las transacciones QR, tal como se muestra en nuestra Referencia de API.