Configuración de Mercado Pago Point Smart en modo PDV

Guía práctica para vincular una terminal Point Smart con un sistema propio

Importante: Todos los identificadores y códigos usados en esta guía son ejemplos ficticios. Cada instalación debe consultar y utilizar sus propios valores de Mercado Pago.

1. Objetivo

El objetivo es dejar un Point Smart preparado para recibir órdenes de cobro desde un sistema externo. El sistema envía el importe a una terminal específica y Mercado Pago procesa el pago en el dispositivo.

2. Requisitos previos

Tener una cuenta de Mercado Pago con el Point Smart asociado.
Crear una aplicación en Mercado Pago Developers: https://www.mercadopago.com.ar/developers
Tener un local y una caja de Mercado Pago para cada Point que se vaya a utilizar.
Disponer del Access Token de la aplicación para realizar las consultas de API.

3. Crear o verificar el local y las cajas

Desde la web de Mercado Pago ingresar en Configuración > Negocio > Locales y cajas. Allí se pueden revisar los locales existentes y las cajas asignadas a cada uno. Si hay más de un Point, conviene tener una caja claramente identificada para cada terminal.

Configuración > Negocio > Locales y cajas.

Después ingresar en Lectores Point para revisar los dispositivos asociados a la cuenta.

Configuración > Negocio > Lectores Point.

4. Identificar físicamente el Point Smart

Si hay más de un Point Smart, primero hay que identificar cuál se va a configurar. En el dispositivo ingresar en Más opciones > Ajustes > Versión de la app.

En el Point Smart: Más opciones > Ajustes > Versión de la app.

La pantalla muestra el número de serie (S/N). Mercado Pago puede mostrar solo los últimos dígitos en algunas vistas.

Ejemplo: si el número de serie físico fuera SMARTPOS1234567890, el identificador de terminal podría verse como PAX_A910__SMARTPOS1234567890.

5. Asociar el Point al local y a la caja

En la ficha del lector, verificar la sección Local y caja. Si la asignación no es la correcta, utilizar la opción Cambiar y seleccionar la caja correspondiente.

Ejemplo de la sección Local y caja en la ficha del Point Smart.

6. Consultar IDs desde PowerShell o CMD

Antes de cambiar el modo de operación conviene consultar los identificadores reales que devuelve Mercado Pago. No se deben inventar ni deducir manualmente.

6.1. Listar terminales – PowerShell

Invoke-RestMethod `
    -Method Get `
    -Uri “https://api.mercadopago.com/terminals/v1/list?limit=50” `
    -Headers @{
        Authorization = “Bearer TU_ACCESS_TOKEN”
    } | ConvertTo-Json -Depth 10

6.2. Listar terminales – CMD

curl -X GET “https://api.mercadopago.com/terminals/v1/list?limit=50” ^
-H “Authorization: Bearer TU_ACCESS_TOKEN”

La respuesta contiene, entre otros datos:

Campo	Significado
id	Terminal ID completo que se utiliza para identificar el Point.
pos_id	ID de la caja a la que está asociado el Point.
store_id	ID del local de Mercado Pago.
operating_mode	Modo de funcionamiento: STANDALONE o PDV.

6.3. Listar cajas – PowerShell

Invoke-RestMethod `
    -Method Get `
    -Uri “https://api.mercadopago.com/pos?limit=50” `
    -Headers @{
        Authorization = “Bearer TU_ACCESS_TOKEN”
    } | ConvertTo-Json -Depth 10

6.4. Listar cajas – CMD

curl -X GET “https://api.mercadopago.com/pos?limit=50” ^
-H “Authorization: Bearer TU_ACCESS_TOKEN”

7. Relacionar terminal, caja y local

La relación se obtiene cruzando los datos devueltos por las APIs. Ejemplo ficticio:

Store ID:    12345678
POS ID:      87654321
Caja:        Caja 1
Terminal ID: PAX_A910__SMARTPOS1234567890
Serie:       SMARTPOS1234567890

Si la consulta de terminales devuelve pos_id = 87654321 para PAX_A910__SMARTPOS1234567890 y la consulta de /pos indica que 87654321 corresponde a “Caja 1”, entonces esa es la relación correcta.

8. Cambiar el Point de STANDALONE a PDV

Para que el sistema pueda enviar órdenes de cobro al Point, la terminal debe quedar en modo PDV. Si al consultar las terminales aparece operating_mode = STANDALONE, se puede realizar el cambio por API.

8.1. PowerShell recomendado

$token = “TU_ACCESS_TOKEN”

$body = @”
{
“terminals”: [
    {
      “id”: “PAX_A910__SMARTPOS1234567890”,
      “operating_mode”: “PDV”
    }
]
}
“@

Invoke-WebRequest `
-Method PATCH `
-Uri “https://api.mercadopago.com/terminals/v1/setup” `
-Headers @{
      Authorization = “Bearer $token”
} `
-ContentType “application/json” `
-Body $body

No copiar literalmente: PAX_A910__SMARTPOS1234567890 es solo un ejemplo. Debe reemplazarse por el campo id obtenido mediante /terminals/v1/list.

8.2. Respuesta esperada

StatusCode        : 200
StatusDescription : OK

{
“terminals”: [
    {
      “id”: “PAX_A910__SMARTPOS1234567890”,
      “operating_mode”: “PDV”
    }
]
}

Una respuesta HTTP 200 indica que Mercado Pago aceptó el cambio. Luego se recomienda reiniciar físicamente el Point Smart.

9. Verificar que quedó en PDV

Después del reinicio, volver a consultar las terminales:

La terminal debe aparecer con:

{
“id”: “PAX_A910__SMARTPOS1234567890”,
“pos_id”: 87654321,
“store_id”: “12345678”,
“operating_mode”: “PDV”
}

10. Datos recomendados para documentar por cada Point

Dato	Ejemplo ficticio
Nombre del local	Local principal
Store ID	12345678
Nombre de caja	Caja 1
POS ID	87654321
Modelo	Point Smart / PAX A910
Número de serie	SMARTPOS1234567890
Terminal ID	PAX_A910__SMARTPOS1234567890
Modo	PDV

11. Flujo de cobro esperado

El vendedor genera una venta en el sistema.
El sistema determina el importe a cobrar.
El backend obtiene el Terminal ID correspondiente a la caja.
El backend crea la orden de cobro en Mercado Pago.
Mercado Pago envía la operación al Point Smart.
El cliente realiza el pago en el dispositivo.
Mercado Pago procesa la operación y el sistema recibe la confirmación correspondiente.

12. Seguridad

Access Token: es una credencial privada. No debe quedar embebida en una aplicación Android, JavaScript de frontend, capturas de pantalla, documentación compartida ni repositorios públicos.

Las llamadas autenticadas a Mercado Pago deben realizarse desde un backend o servidor controlado.

Documento de referencia – utilizar siempre los identificadores reales obtenidos desde la API en cada instalación.

En Alfa Gestión

Ir a la opcion Utilidades, configuracion del sistema, solapa Medios de pago.

clic en “Configurar Point”

Aqui copiar el Access Token, obtenido de Mercado Pago

Puede seleccionar varios medios de pago, que apunten al mismo Point, con cualquiera de estos medios de pago el sistema conectara con el point y le enviara el total a cobrar.

Finalmente puedo asignar una caja o cajero al Smart Point, simplemte por seguridad, no cualquier caja lo puede usar.

Configuración de Mercado Pago Point Smart

1. Objetivo

2. Requisitos previos

3. Crear o verificar el local y las cajas

4. Identificar físicamente el Point Smart

5. Asociar el Point al local y a la caja

6. Consultar IDs desde PowerShell o CMD

6.1. Listar terminales – PowerShell

6.2. Listar terminales – CMD

6.3. Listar cajas – PowerShell

6.4. Listar cajas – CMD

7. Relacionar terminal, caja y local

8. Cambiar el Point de STANDALONE a PDV

8.1. PowerShell recomendado

8.2. Respuesta esperada

9. Verificar que quedó en PDV

10. Datos recomendados para documentar por cada Point

11. Flujo de cobro esperado

12. Seguridad

En Alfa Gestión

Me gusta esto:

Relacionado

Deja una respuesta Cancelar la respuesta

1. Objetivo

2. Requisitos previos

3. Crear o verificar el local y las cajas

4. Identificar físicamente el Point Smart

5. Asociar el Point al local y a la caja

6. Consultar IDs desde PowerShell o CMD

6.1. Listar terminales – PowerShell

6.2. Listar terminales – CMD

6.3. Listar cajas – PowerShell

6.4. Listar cajas – CMD

7. Relacionar terminal, caja y local

8. Cambiar el Point de STANDALONE a PDV

8.1. PowerShell recomendado

8.2. Respuesta esperada

9. Verificar que quedó en PDV

10. Datos recomendados para documentar por cada Point

11. Flujo de cobro esperado

12. Seguridad

En Alfa Gestión

Compartir:

Me gusta esto:

Relacionado

Deja una respuesta Cancelar la respuesta