Crear sucursal y caja - Etapas de integración - Mercado Pago Developers
Crear sucursal y caja
Después de configurar el entorno de la terminal de debug para recibir tu SmartApp, integrar y probar el flujo de pago de nuestro SDK, será necesario crear las sucursales y cajas que serán responsables de la operación de esos terminals antes de enviar tu aplicación para validación y distribución en los terminals.
Una sucursal representa a una tienda física dentro de Mercado Pago, que puede tener una o más cajas vinculadas. Sin embargo, cada caja solo permite una terminal asociada. Esto quiere decir que, si estás queriendo integrar más de una terminal, deberás crear la misma cantidad de cajas y realizar su asociación de manera individual.
La creación y posterior configuración de sucursales y cajas pueden realizarse por dos vías: mediante panel de Mercado Pago, o vía API. Esta última opción es útil para sistemas que requieran operar con varios puntos de venta, ya que permite asociar varias sucursales desde el sistema integrador.
Es posible crear sucursales y cajas desde tu sistema a través de nuestras APIs para pagos presenciales. Para eso, sigue los pasos a continuación.
Para crear una sucursal vía API, envía un POST con el Access Token que corresponda a tu tipo de integración (para tu propio terminalIntegraciones de Mercado Pago Point a tu sistema para uso propio y configuradas a partir de credenciales de producción de tu aplicación. Para más información, accede al link a continuación.Acceder a las credenciales o para tercerosIntegraciones de Mercado Pago Point a tu sistema en nombre de un vendedor y configuradas a partir de credenciales obtenidas a través del protocolo de seguridad OAuth. Para más información, accede al link a continuación.Acceder a las credenciales) al endpoint Crear sucursalAPI. Deberás agregar el user_id de la cuenta de Mercado Pago que recibirá el dinero de las transacciones en el path de tu solicitud y completar los parámetros requeridos con los detalles del negocio según se indican a continuación.
Es fundamental completar correctamente toda la información de ubicación de la sucursal (city_name, state_name, latitude y longitude). Los datos incorrectos pueden causar errores en los cálculos de impuestos, impactando directamente la facturación y la regularización fiscal de tu empresa.
Identificador de la cuenta de Mercado Pago que recibe el dinero por las ventas realizadas en la sucursal. Si estás realizando una integración para tu propio terminalIntegraciones de Mercado Pago Point a tu sistema para uso propio y configuradas a partir de credenciales de producción de tu aplicación. Para más información, accede al link a continuación.Acceder a las credenciales, encontrarás este valor en los Detalles de aplicación. Si, en cambio, estás realizando una integración parpara tercerosIntegraciones de Mercado Pago Point a tu sistema en nombre de un vendedor y configuradas a partir de credenciales obtenidas a través del protocolo de seguridad OAuth. Para más información, accede al link a continuación.Acceder a las credenciales, obtendrás el valor en la respuesta a la vinculación por medio de OAuthClave privada generada mediante el protocolo de seguridad OAuth, que permite gestionar integraciones en nombre de terceros. Para más información, dirígete a la documentación.OAuth.
name
Obligatorio
Nombre de la sucursal creada.
external_id
Opcional
Identificador externo de la tienda para el sistema del integrador. Puede contener cualquier valor alfanumérico de hasta 60 caracteres, y debe ser único para cada sucursal. Por ejemplo, SUCMercadoPago.
location
Obligatorio
Este objeto debe contener todos los datos relativos a la ubicación de la sucursal. Debes prestar particular atención a completarlos correctamente con el estándar decimal simple, en especial los parámetros latitude y longitude, con los datos reales de la ubicación física. Por ejemplo, "latitude": 27.175193925922862, y "longitude": 78.04213533235064 corresponden a la ubicación exacta del Taj Mahal, en India.
Si la solicitud fue enviada correctamente, la respuesta se verá como el ejemplo a continuación.
Además de los datos enviados en la solicitud, devolverá el identificador asignado a esa sucursal por Mercado Pago bajo el parámetro id.
La creación de sucursales y cajas por medio del Panel de Mercado Pago es la opción para quienes solo deban gestionar un punto de venta y prefieran simplificar el proceso. Para hacerlo, ingresa a tu cuenta de Mercado Pago, y sigue las instrucciones a continuación.
En el menú lateral izquierdo, dirígete a Tu negocio > Sucursales y cajas.
En la sección “Listado de locales”, haz clic en el botón + Agregar local.
Completa el Nombre y la Dirección de tu nuevo local, suma opcionalmente Datos extra, en caso de necesitar mayor detalle, y haz clic en Continuar.
Completa la información requerida con el horario de funcionamiento del local, seleccionando los días y horarios de apertura. Al terminar, haz clic en Continuar.
Las opciones disponibles en esta pantalla se adecúan a múltiples escenarios. Te permitirá seleccionar un solo horario para todos los días de la semana, o bien un horario distinto para cada uno, junto con la posibilidad de ingresar horarios especiales para días feriados. Elige la opción que mejor se adapte a tu tienda.
A continuación, te encontrarás en la pantalla para crear cajas asociadas al local, donde deberás asignarle un Nombre. Si lo deseas, puedes crear más de una caja.
Recuerda que solo es posible configurar una terminal Point por caja. Si deseas integrar varias terminals, deberás crear una caja para cada una de ellas.
Haz clic en el botón Continuar, ¡y listo! Ya creaste y configuraste tu local y tu caja.
Los IDs devueltos (store_id y pos_id) después de crear las sucursales y cajas deberán ser informados a tu representante de Mercado Pago. Así, podrás continuar con el proceso de publicación del SmartApp.