Endpoints disponibles
Todos los endpoints que componen la integración de Mercado Pago Point, 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 y terminals que operan en ese local.
| Operación | Path | Descripción |
| Crear sucursalPOST | /users/{user_id}/stores | Registra una sucursal física donde operarán las cajas y terminals Point. |
| Buscar en sucursalesGET | /users/{user_id}/stores/search | Busca sucursales por external_id u otros parámetros disponibles; devuelve resultados paginados. |
| Obtener sucursalGET | /stores/{id} | Obtiene los datos de registro de una sucursal: nombre, horario comercial, ubicación e identificador externo. |
| 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. Al crearla, puedes vincularla a una terminal Point para que reciba las orders de cobro.
| Operación | Path | Descripción |
| Crear cajaPOST | /pos | Crea una caja en una sucursal y la vincula a una terminal Point para procesar cobros. |
| Buscar en cajasGET | /pos | Busca cajas por external_id u otros parámetros disponibles; devuelve resultados paginados. |
| Obtener cajaGET | /pos/{id} | Obtiene el detalle de una caja, incluyendo su estado y configuración. |
| Actualizar cajaPUT | /pos/{id} | Actualiza la configuración de una caja existente. |
| Eliminar cajaDELETE | /pos/{id} | Elimina una caja y desvincula la terminal asociada. |
Las terminals son los dispositivos físicos de Mercado Pago Point asociados a tu cuenta. Puedes consultarlas y configurar su modo de operación vía API.
| Operación | Path | Descripción |
| Obtener lista de terminalsGET | /terminals/v1/list | Lista las terminals disponibles para la cuenta; devuelve identificador, modo de operación y caja asociada de cada una. |
| Actualizar modo de operación de la terminalPATCH | /terminals/v1/setup | Cambia el modo de operación de la terminal de STANDALONE (autónomo) a PDV (integrado al sistema). |
Las orders son las solicitudes de cobro que se envían a la terminal. Tu backend crea la order con el monto y la caja destino; la terminal la recibe automáticamente y el cliente realiza el pago.
| Operación | Path | Descripción |
| Crear orderPOST | /v1/orders | Crea una order de cobro y la envía a la terminal vinculada a la caja; el cliente realiza el pago. |
| Obtener order por IDGET | /v1/orders/{id} | Obtiene el estado y detalle de una order, incluido el resultado del pago en la terminal. |
| Cancelar order por IDPOST | /v1/orders/{id}/cancel | Cancela una order pendiente antes de que sea procesada por la terminal. |
| Reembolsar una orderPOST | /v1/orders/{id}/refund | Reembolsa una order procesada, total o parcialmente. |
| Simular estado de la orderPOST | /v1/orders/{id}/events | Simula el resultado de una order en entorno de pruebas con los estados approved, rejected o cancelled, sin procesar un pago real. |
| 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. |