Configurar integración de prueba - Prueba de integración - Mercado Pago Developers
¿Qué documentación quieres buscar?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos

Configurar integración de prueba

Para poder probar tu integración con Mercado Pago Point y el procesamiento de pagos, primero debes configurar tu integración. En esta documentación encontrarás el paso a paso para hacerlo de manera adecuada utilizando nuestras APIs.

Importante
Para probar tu integración con dispositivos Point deberás utilizar tu usuario Mercado Pago y sus credenciales productivas, ya que no están habilitados los pagos con usuarios de prueba.

Crear una sucursal y una caja

  1. Crea una sucursal realizando un llamado al endpoint Crear sucursal. Deberás enviar tu Access Token productivo, y reemplazar el valor user_id por la identificación de usuario que te fue asignada al crear tu aplicación. Si tienes dudas sobre cómo identificar este valor, accede a la documentación sobre Detalles de aplicación.

  2. Crea una caja realizando un llamado al endpoint Crear caja, y asóciala a la sucursal creada en el paso anterior. Esto se logra reemplazando los parámetros external_store_id por el external_id que le asignaste a la sucursal, o store_id por el valor obtenido para el campo id en la respuesta a la creación de la sucursal.

  3. Por último, asocia el dispositivo Point a tu cuenta de Mercado Pago. Para eso, descarga e instala la app de Mercado Pago en tu dispositivo móvil, inicia sesión con tu cuenta, y oprime el ícono QR para escanear el código que aparece al encender el dispositivo Point.

Activar el modo PDV

La activación del modo operativo Punto de Venta (PDV) en tu dispositivo es un requisito indispensable para operar con nuestra API. Este proceso consta de dos etapas:

  1. Primero, deberás obtener la identificación de tu dispositivo Point. Para hacerlo, realiza un llamado al endpoint Obtener dispositivos, que te devolverá un listado de aquellos dispositivos asociados a la cuenta de Mercado Pago. Podrás identificar el Point que deseas activar por medio de los últimos caracteres del campo id, que deberán coincidir con el serial que aparece en la etiqueta trasera del dispositivo. Recuerda que debes realizar este llamado utilizando tus credenciales productivas.
Nota
Recomendamos enviar en esta solicitud los query params store_id y pos_id para verificar que la configuración sea correcta. Los mismos permitirán obtener no sólo los dispositivos asociados a una cuenta de Mercado Pago, sino también aquellos vinculados específicamente a una sucursal y una caja dentro de esa cuenta, respectivamente. Los valores de estos parámetros serán aquellos recibidos en las respuestas a la creación de cada una.
  1. Por último, realiza una solicitud PATCH al endpoint Cambiar el modo de operación, reemplazando el valor device-id del path por el id del dispositivo obtenido en el paso anterior. Además, deberás completar el campo operating_mode con el valor PDV, que habilita el funcionamiento del dispositivo en el modo integrado con la API.

Configurar notificaciones

Previo a iniciar las pruebas con el procesamiento de pagos, recomendamos configurar las notificaciones Webhooks por medio de la sección Tus Integraciones. De esta manera, podrás probar también estar recibiendo las alertas necesarias para cada transacción realizada, y contrastar la información recibida con tu sistema.

Para configurar tus notificaciones con Mercado Pago Point, sigue las instrucciones a continuación:

  1. Ingresa a Tus Integraciones y selecciona la aplicación con la que estás probando tu integración.
  2. En el menú de la izquierda, haz clic en Webhooks.
  3. En la pantalla desplegada, haz clic en Configurar notificaciones, y configura la URL que serán utilizadas para recibir las notificaciones de prueba. Recomendamos proporcionar una URL modo producción para recibir notificaciones tanto tu integración de prueba como de la productiva.
  4. Selecciona Integraciones Point como el tópico sobre el cual deseas recibir notificaciones. Esto te mantendrá actualizado sobre las intenciones de pago y sus cambios de estado.
  5. Por último, haz clic en Guardar. Esto generará una clave secreta exclusiva para la aplicación, que permitirá validar la autenticidad de las notificaciones recibidas, garantizando que hayan sido enviadas por Mercado Pago. Si quieres obtener más información sobre cómo validar el origen de una notificación, accede a la documentación.

Una vez que hayas realizado todas las configuraciones, puedes comenzar a probar el procesamiento de pagos.