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 de pago.

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.

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 > Detalles de aplicació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.Acceder a las credenciales de prueba al endpoint Crear sucursalAPI. Deberás añadir 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 lo indicado.

curl
Copiar
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
Copiar
{
  "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.

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 > Detalles de la aplicació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.Acceder a las credenciales de prueba al endpoint Crear cajaAPI como se muestra a continuación.

curl
Copiar
curl -X POST \
    'https://api.mercadopago.com/pos'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer ACCESS_TOKEN' \
    -d '{
  "name": "First POS",
  "fixed_amount": true,
  "store_id": 1234567,
  "external_store_id": "LOJ001",
  "external_id": "LOJ001POS001",
  "category": 621102
}'

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

json
Copiar
{
  "id": 2711382,
  "qr": {
    "image": "https://www.mercadopago.com/instore/merchant/qr/2711382/0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png",
    "template_document": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.pdf",
    "template_image": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png"
  },
  "status": "active",
  "date_created": "2019-08-22T14:11:12.000Z",
  "date_last_updated": "2019-08-25T15:16:12.000Z",
  "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
  "user_id": 446566691,
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001"
}

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.