Integra la API a tus Puntos de Venta
Sigue estos pasos para empezar a integrar la API de Integraciones a tus Puntos de Venta.
1. Obtén las credenciales de identificación
Accede a una cuenta de Mercado Pago
Para poder comenzar la integración, es necesario contar con una cuenta de Mercado Pago o Mercado Libre. Puedes Ingresar a una cuenta ya existente o Crear una cuenta nueva.
Crea una aplicación
Luego, necesitarás crear una aplicación para obtener las credenciales. Es fácil, te contamos cómo hacerlo:
- Ingresa a Tus integraciones.
- Dentro de la sección Tus aplicaciones, haz clic en el signo "+" para crear tu primera aplicación, o elige “Crear nueva aplicación” si ya tienes otras.
- Ponle un nombre a tu aplicación con el que puedas identificarla más adelante.
- Elige "Mercado Pago Point" como producto que vas a integrar.
- Acepta nuestros Términos y Condiciones.
¡Y listo!
Accede a las credenciales de tu aplicación
Después de crear una aplicación, puedes acceder a ellas en Detalles de la aplicación > Credenciales dentro del Panel del desarrollador. Con ellas puedes conectar una integración a tu cuenta y configurarla a tu manera.
Genera usuarios de prueba
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:
- En el Devsite, navega hasta Tus integraciones y haz clic en la tarjeta correspondiente a tu aplicación.
- 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.
- En la pantalla "Crear nueva cuenta", ingresa una descripción para identificar la cuenta. Por ejemplo: "Vendedor - tienda 1".
- 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.
- 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.
- 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.
- 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.
Además, también puedes crear usuarios de prueba usando el siguiente comando:
curl
curl -X POST \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ${TEST_ACCESS_TOKEN}' \
"https://api.mercadopago.com/users/test" \
-d '{"site_id":"MLA","description" : "a description"}'
2. Asocia tu dispositivo Point a tu cuenta de Mercado Pago
Ahora vas a vincular tu dispositivo Point a tu cuenta de Mercado Pago. Para eso, necesitas contar con nuestra aplicación en tu celular. Puedes obtenerla para sistemas operativos iOS y Android. También deberás contar con un dispositivo Point.
Escanea el código QR de tu dispositivo Point
Primero, inicia sesión en la aplicación de Mercado Pago. Luego, oprime en el ícono QR y escanea el código que aparece al encender tu dispositivo Point. Y listo, tu dispositivo Point quedará vinculado a tu cuenta.
Configura tu tienda y tu caja
Una vez que hayas vinculado tu dispositivo Point a tu cuenta de Mercado Pago, debes completar los datos de tu negocio y configurar tu caja en el sitio de Mercado Pago. Para hacerlo, deberás ingresar en Tu negocio > Locales y cajas.
Activa el modo integrado en tu dispositivo Point
Para integrar tu dispositivo Point con nuestra API es necesario activar el modo operativo punto de venta (PDV). Para lograrlo, consulte los dispositivos a través de la API Obtener dispositivos y ejecute el siguiente comando:
bash
curl --location --request PATCH 'https://api.mercadopago.com/point/integration-api/devices/:deviceId' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
"operating_mode": "PDV"
}'
Recibirás una respuesta como esta:
json
{
"operating_mode": "PDV"
}
operating_mode
con el valor STANDALONE
.