Sugiere cambios
Ayúdanos a mejorar la documentación
¿Viste información errónea, te gustaría que expliquemos algo más o que mejoremos nuestras guías? Déjanos tus sugerencias en GitHub.

Sucursales y Cajas

Introducción

Las sucursales y cajas son importantes para recibir pagos presenciales con QR. Te permiten crear tu tienda y asignar sus puntos de venta.

Término Descripción
Sucursal Es una tienda física en la que tus clientes pueden adquirir tus productos o servicios. Puedes tener varias sucursales en una misma cuenta.
Caja Es un punto de venta que existe en una sucursal o tienda física. Cada caja tendrá vinculado un código QR unívoco.

Cajas y Sucursales

Sucursales

¿Cuáles son los beneficios de crear sucursales?

Los beneficios de crear sucursales son:

  • Lograr trazabilidad. Cada pago quedará asociado a una sucursal y al momento de obtener tus reportes de conciliación será valioso para identificar transacciones por sucursal.
  • Visibilidad en mapas de sucursales. Las sucursales creadas aparecen en el mapa de las app de Mercado Pago o Mercado Libre a medida que vayan teniendo pagos. De esta manera, dan visibilidad a todos los clientes sobre la existencia de la tienda.
  • Aportar una mejor organización de las cajas.

¿Cómo crear una sucursal?

Para crear un sucursal tienes que declarar su nombre, horarios de trabajo, ubicación y alguna referencia que lo identifique.

Ejecuta el siguiente código para generarla:

curl -X POST https://api.mercadopago.com/users/$COLLECTOR_ID/stores?access_token=PROD_ACCESS_TOKEN -d
{  
   "name":"Sucursal Instore",
   "business_hours":{  
      "monday":[  
         {  
            "open":"08:00",
            "close":"13:00"
         },
         {  
            "open":"15:00",
            "close":"18:00"
         }
      ],
      "tuesday":[  
         {  
            "open":"08:00",
            "close":"18:00"
         }
      ]   
   },
   "location":{  
      "street_number":"3039",
      "street_name":"Caseros",
      "city_name":"Belgrano",
      "state_name":"Capital Federal",
      "latitude":-32.8897322,
      "longitude":-68.8443275,
      "reference":"3er Piso"
   },
   "external_id":"STORE001"
}

Puedes obtener más información en la Referencias de API.

Cajas

Al tener creadas tus sucursales, puedes crear tus cajas. Ten en cuenta lo siguiente:

Término Descripción
EXTERNAL_STORE_ID Vincula la caja con la sucursal. Es un campo requerido y es el mismo external_id de la Sucursal previamente creada.
EXTERNAL_ID Identifica unívocamente cada caja. Es requerido y no se puede modificar, tampoco repetir en una misma cuenta de Mercado Pago.
curl -X POST https://api.mercadopago.com/pos?access_token=PROD_ACCESS_TOKEN -d     
{
  "name":"Caja Principal", 
  "fixed_amount": true,
  "category": 621102,
  "external_store_id": "STORE001",
  "external_id": "CAJA0001"
}

Puedes obtener más información en la Referencias de API.

Una vez creada la caja, podremos ver en el Response los links a distintos entregables del QR, junto con otros datos relevantes de la caja.

Próximos pasos

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.