Crear sucursal y caja

Después de crear la aplicación y obtener las credenciales, es necesario configurar la sucursal y caja, que estarán asociados a las transacciones.

Las sucursales representan establecimientos físicos registrados en Mercado Pago y pueden tener una o más cajas vinculadas. Las cajas corresponden a los puntos de venta (PDVs) y deben siempre estar asociadas a una sucursal, garantizando la conciliación de pagos por Código QR en establecimientos físicos.

Es posible crear tiendas y cajas desde tu sistema a través de nuestras APIs para pagos presenciales. Para ello, sigue los pasos a continuación.

Crear sucursal

Para crear una sucursal vía API, envía un POST incluyendo tu Access Token de pruebaClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de integración > Pruebas > Credenciales de prueba. Durante la integración, utiliza el Access Token de prueba y, al finalizar, reemplázalo por el Access Token de producción si se trata de una integración propia, o por el Access Token obtenido mediante OAuth en el caso de integraciones de terceros. Para más información, dirígete a la documentación. El Access Token de prueba comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba al endpoint Crear sucursalAPI. Deberás agregar el user_id de la cuenta de pruebaDurante el desarrollo, utiliza el User ID de la cuenta de prueba. Accede a Tus integraciones > Datos de integración > Credenciales de prueba > Datos de las credenciales de prueba y copia el User ID que se muestra. Al salir a producción, reemplázalo por el User ID de la cuenta real de Mercado Pago que recibirá los pagos. en el path de tu solicitud y completar los parámetros requeridos con los detalles del negocio según se indican a continuación.

curl
curl -X POST \
    'https://api.mercadopago.com/users/USER_ID/stores'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer ACCESS_TOKEN' \
    -d '{
  "name": "Sucursal Instore",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "external_id": "LOJ001",
  "location": {
    "street_number": "0123",
    "street_name": "Nombre de la calle de ejemplo.",
    "city_name": "Nombre de la ciudad.",
    "state_name": "Nombre del estado.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Cerca de Mercado Pago."
  }
}'

Si la solicitud fue enviada correctamente, la respuesta será como el ejemplo a continuación:

json
{
  "id": 1234567,
  "name": "Sucursal Instore",
  "date_created": "2019-08-08T19:29:45.019Z",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "location": {
    "address_line": "Nombre de la calle de ejemplo, 0123, Nombre de la ciudad, Nombre del estado.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Cerca de Mercado Pago"
  },
  "external_id": "LOJ001"
}

Además de los datos enviados en la solicitud, el endpoint devolverá el identificador asignado a la tienda por Mercado Pago bajo el parámetro id.

Crear caja

Para habilitar ventas con Mercado Pago, es indispensable que cada tienda registrada tenga al menos una caja vinculada. Para crear una caja y asociarla a la tienda previamente creada, envía un POST incluyendo tu Access Token de pruebaClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de integración > Pruebas > Credenciales de prueba. Durante la integración, utiliza el Access Token de prueba y, al finalizar, reemplázalo por el Access Token de producción si se trata de una integración propia, o por el Access Token obtenido mediante OAuth en el caso de integraciones de terceros. Para más información, dirígete a la documentación. El Access Token de prueba comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba al endpoint Crear cajaAPI como se muestra a continuación.

curl
curl -X POST \
    'https://api.mercadopago.com/v2/pos'\
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ACCESS_TOKEN' \
    -H 'X-Idempotency-Key: CLAVE_UNICA' \
    -d '{
  "name": "POS-001",
  "store_id": "1234567",
  "external_id": "LOJ001POS001",
  "config": {
    "qr": {
      "operating_mode": "pdv"
    }
  }
}'

Si la solicitud fue enviada correctamente, la respuesta será como el ejemplo a continuación:

json
{
  "id": 1234567,
  "name": "POS-001",
  "status": "active",
  "date_created": "2024-01-15T10:30:00Z",
  "date_last_updated": "2024-01-15T10:30:00Z",
  "user_id": 123456,
  "store_id": "1234567",
  "external_store_id": "LOJ001",
  "external_id": "LOJ001POS001",
  "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"
  }
}

Consulta en la tabla a continuación la descripción de algunos de los parámetros retornados que pueden ser útiles para continuar con tu integración más adelante.

Si ambas solicitudes son exitosas, habrás creado y configurado la tienda y la caja necesarias para la integración con Código QR.

Con la tienda y la caja creadas, podrás integrar el procesamiento de pagos.