Recursos para IA
Obtener caja

Este endpoint permite obtener la configuración de un punto de venta específico identificado por su ID. El punto de venta debe pertenecer al usuario del Access Token. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

https://api.mercadopago.com/v2/pos/{pos_id}
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
pos_id
string

REQUERIDO

Es el identificador numérico del punto de venta, asignado automáticamente por Mercado Pago al momento de la creación. Debe ser un entero válido mayor o igual a 0.
Response parameters
id
integer
Es el identificador numérico único del punto de venta, generado automáticamente por Mercado Pago al momento de la creación. Al registrar un punto de venta, recibirás un ID correspondiente. Este ID puede ser utilizado par
name
string
Es el nombre del punto de venta, definido por el integrador al momento de la creación.
status
string
Indica el estado actual del punto de venta. Valores posibles: active (el punto de venta está activo y disponible para recibir pagos) e inactive (el punto de venta está inactivo y no puede recibir pagos).
undefined: undefined
undefined: undefined
date_created
string
Es la fecha y hora de creación del punto de venta. Este campo muestra la fecha y hora en el formato ISO 8601, como 2024-08-08T19:29:45.019Z.
Errores

400Solicitud incorrecta

resource_bad_request_error

El pos_id proporcionado en el path no es un entero válido o es negativo. Verifica que el valor sea un entero base-10 no negativo.

bad_request

El pos_id proporcionado en el path no es un entero válido o no pertenece al usuario del Access Token. Verifica que el valor sea un entero base-10 no negativo y que el punto de venta esté asociado a tu cuenta.

401No autorizado

unauthorized

El valor enviado como Access Token es incorrecto o está ausente. Por favor, verifícalo e intenta nuevamente con un Access Token válido.

404No encontrado

pos_not_found

No se encontró ningún punto de venta para el pos_id proporcionado y el usuario del Access Token. Verifica que el ID sea correcto y pertenezca a tu cuenta.

500Error interno del servidor

internal_server_error

Ocurrió un error inesperado en el servidor. Se trata de una falla transitoria no relacionada con los datos de la solicitud. Por favor, vuelve a intentarlo después de unos momentos.

Request
curl -X GET \
    'https://api.mercadopago.com/v2/pos/{pos_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    
Response
{
  "id": 1234567,
  "name": "POS-001",
  "status": "active",
  "date_created": "2024-01-15T10:30:00Z",
  "date_last_updated": "2024-03-01T08:00:00Z",
  "user_id": 123456,
  "external_id": "SUC001POS001",
  "config": {
    "qr": {
      "operating_mode": "pdv"
    }
  },
  "qr_response": {
    "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
    "image": "https://www.mercadopago.com/instore/merchant/qr/1234567/abc123.png",
    "template_document": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.pdf",
    "template_image": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.png",
    "qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/abc123"
  }
}