Requisitos previos

Ten en cuenta estos aspectos antes de empezar:

• Accede a una cuenta
• Crea una aplicación
• Genera usuarios de prueba
• Obtén tu Access token
• Identifica tu integración

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.

Para realizar transacciones a través de la integración de Mercado Pago, se debe crear una credencial. Esta credencial tendrá una identificación y un Access token, solo con este token podrás realizar transacciones utilizando una cuenta de Mercado Pago.

Crea una aplicación para obtener credenciales y configurar notificaciones Webhooks.

Es fácil, te contamos cómo hacerlo:

1. Ingresa a Tus integraciones y haz clic en Crear aplicación.
2. Ponle un nombre con el que puedas identificarla más adelante.
3. Selecciona la opción Pagos presenciales, y luego CódigoQR.
4. Opcionalmente, puedes seleccionar el modelo de integración, sea atendido o dinámico.
5. Acepta nuestros Términos y Condiciones, y haz clic en Crear aplicación. ¡Listo!

Utiliza cuentas de prueba para asegurar que tu integración soporta todos los flujos y escenarios posibles. Tienen las mismas características que una cuenta real de Mercado Pago, lo que te permite probar el funcionamiento de las integraciones que estás desarrollando.

Para realizar la prueba, debes tener al menos dos cuentas:

• Vendedor: cuenta requerida para configurar la aplicación y las credenciales. Esta es tu cuenta de usuario.
• Comprador: cuenta necesaria para probar el proceso de compra.

Además de estas cuentas, también es importante utilizar las tarjetas de prueba para probar la integración de pago y simular el proceso de compra, así como el saldo en la cuenta de Mercado Pago del usuario de prueba. Te mostramos más detalles a continuación.

Para crear cuentas y probar el funcionamiento de las integraciones, sigue los siguientes pasos:

1. En el Devsite, navega hasta Tus integraciones y haz clic en la tarjeta correspondiente a tu aplicación.
2. En la página de la aplicación, ve a la sección Cuentas de prueba y haz clic en el botón + Crear cuenta de prueba.
3. En la pantalla "Crear nueva cuenta", ingresa una descripción para identificar la cuenta. Por ejemplo: "Vendedor - tienda 1".
4. A continuación, selecciona el país de operación de la cuenta. Esta información no se podrá editar más adelante, y además, los usuarios Comprador y Vendedor deben ser del mismo país.
5. Ingresa un valor ficticio en dinero que servirá como referencia para probar tus aplicaciones. Este valor aparecerá como saldo en la cuenta de Mercado Pago del usuario de prueba y se podrá utilizar para simular pagos, al igual que con las tarjetas de prueba.
6. Autoriza el uso de tus datos personales de acuerdo con la Declaración de Privacidad y asegúrate de que tu cuenta utiliza las herramientas de Mercado Pago según los Términos y Condiciones marcando la casilla de selección.
7. Haz clic en Crear cuenta de prueba.

¡Listo! La cuenta de prueba se ha creado y se mostrará en la tabla con la siguiente información:

• País: Lugar de origen de la cuenta seleccionado en tu registro.
• Identificación de la cuenta: Descripción para identificar la cuenta de prueba.
• Usuario: Nombre de usuario de la cuenta de prueba generado automáticamente. Este es el nombre de usuario que se utiliza para iniciar sesión con el test user.
• Contraseña: Contraseña de acceso a la cuenta del usuario de prueba generada automáticamente. Para generar una nueva contraseña, haz clic en los 3 puntos verticales al final de la línea de la tabla y selecciona la opción Generar nueva contraseña.
• Creado en: Fecha en que se creó la cuenta de prueba.

Una vez creados los usuarios de prueba, ya puedes comenzar con la integración y crear las sucursales y cajas.

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.

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.