Endpoints disponibles
Todos los endpoints que componen la integración de QR Code, desde la configuración inicial de la infraestructura hasta la gestión de los cobros. Para integraciones en nombre de terceros, autentica las llamadas a esta API con OAuth.
Las sucursales representan las ubicaciones físicas de tu negocio. Cada sucursal agrupa las cajas donde se generan los códigos QR.
| Operación | Path | Descripción |
| Crear sucursalPOST | /users/{user_id}/stores | Registra una sucursal física donde operarán las cajas con QR Code. |
| Obtener sucursalGET | /stores/{id} | Obtiene los datos de registro de una sucursal: nombre, horario comercial, ubicación e identificador externo. |
| Buscar en sucursalesGET | /users/{user_id}/stores/search | Busca sucursales por external_id u otros parámetros disponibles; devuelve resultados paginados. |
| Actualizar sucursalPUT | /users/{user_id}/stores/{id} | Actualiza los datos de configuración de una sucursal existente. |
| Eliminar sucursalDELETE | /users/{user_id}/stores/{id} | Elimina una sucursal y la desvincula de sus cajas. |
Cada caja es un punto de venta dentro de una sucursal asociado a un QR Code estático. En el modo dinámico o híbrido, la order genera además un QR único por transacción.
| Operación | Path | Descripción |
| Crear cajaPOST | /pos | Crea una caja en una sucursal, genera el QR Code estático y permite definir el modo de operación del punto de venta. |
| Obtener cajaGET | /pos/{id} | Obtiene el detalle de una caja, incluido el qr_code para mostrarlo en el punto de venta. |
| Buscar en cajasGET | /pos | Busca cajas por external_id u otros parámetros disponibles; devuelve resultados paginados. |
| Actualizar cajaPUT | /pos/{id} | Actualiza la configuración de una caja existente. |
| Eliminar cajaDELETE | /pos/{id} | Elimina una caja y su QR Code asociado. |
Las orders son las solicitudes de cobro procesadas vía QR Code. Según el modo configurado, la order se asigna al QR estático de la caja, genera un QR dinámico por transacción, o combina ambos en modo híbrido; en todos los casos el cliente paga escaneando el código con la app de Mercado Pago.
| Operación | Path | Descripción |
| Crear orderPOST | /v1/orders | Crea una order de cobro procesada vía QR Code; en modo estático se asigna al QR de la caja, en modo dinámico genera un QR por transacción, y en modo híbrido activa ambos; el cliente paga escaneando el código con la app de Mercado Pago. |
| Obtener order por IDGET | /v1/orders/{id} | Obtiene el estado y detalle de una order, incluido el resultado del pago. |
| Reembolsar una orderPOST | /v1/orders/{id}/refund | Reembolsa una order pagada, total o parcialmente. |
| Cancelar order por IDPOST | /v1/orders/{id}/cancel | Cancela una order pendiente antes de que sea pagada por el cliente. |
| Operación | Path | Descripción |
| Obtener contracargoGET | /v1/chargebacks/{id} | Obtiene el detalle de un contracargo: estado de la disputa, monto afectado y plazo para responder. |