Endpoints disponibles
Todos los endpoints que componen la integración de Código QR, 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 código QR. |
| 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 código QR 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 código QR 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 código QR asociado. |
Las orders son las solicitudes de cobro procesadas vía código QR. 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 código QR; 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. |
Endpoints para que billeteras digitales externas puedan autenticarse, consultar planes de cuotas, tokenizar datos de tarjeta y procesar pagos con tarjeta de crédito en códigos QR generados por Mercado Pago.
| Operación | Path | Descripción |
| Resolver QRGET | /instore/v2/external/resolve | Resuelve el contenido raw del QR escaneado y retorna el order.id y los métodos de pago disponibles. |
| Consultar planes disponiblesPATCH | /instore/v2/external/orders/{order_id}/plans | Retorna los planes de cuotas disponibles para los BINs de tarjeta y el monto del pedido. |
| Generar Acceptor TokenPOST | /instore/v2/external/payments/tokens | Tokeniza datos de tarjeta (Card Data o Brand Token) para usarlos como Acceptor Token en el endpoint de procesar el pago. |
| Procesar el pagoPOST | /instore/v2/external/orders/{order_id}/payments | Procesa el pago con tarjeta de crédito usando Card Data, Brand Token o Acceptor Token. |
| Consultar pago por payment IDGET | /instore/v2/external/payments/{payment_id} | Retorna el detalle y estado de un pago a partir de su ID. |
| Consultar pagos por order IDGET | /instore/v2/external/orders/{order_id}/payments | Retorna la lista de pagos asociados a un pedido. |
| Operación | Path | Descripción |
| Obtener contracargoGET | /v1/chargebacks/{id} | Busca un caso de contracargo a partir de su ID devuelto en el body de la notificación configurada. Devuelve el detalle de un contracargo: el status de la disputa, el monto afectado y el plazo para responder. |
| Buscar contracargosGET | /v1/chargebacks/search | Busca todos los contracargos de un pago por su "payment_id" devuelto en el body de la notificación configurada. La búsqueda devuelve resultados paginados con el detalle de cada caso. |
| Enviar documentación probatoriaPOST | /v1/chargebacks/{id}/documentation | Sube archivos de evidencia para disputar un contracargo mientras su status ("documentation_status") sea "pending". |
| Obtener archivo de documentación probatoriaGET | /v1/chargebacks/documentation/{type}/{uuid} | Descarga o renderiza en línea un archivo de documentación subido para un caso de contracargo. |