Referencia API
Base URL
| Entorno |
URL |
| Producción |
https://mercadopago.histrix.com.ar |
| Local |
http://localhost:5173 |
Autenticación
Todas las rutas (excepto webhooks y OAuth login/callback) requieren:
x-api-token: <admin_token | client_api_key>
Resumen de endpoints
Públicos (sin auth)
| Método |
Ruta |
Descripción |
| GET |
/health |
Health check |
| GET |
/docs |
Documentación Scalar |
| GET |
/openapi.json |
Spec OpenAPI 3.1 |
| GET |
/dashboard |
Dashboard UI |
| GET |
/oauth/login |
Inicio OAuth PKCE |
| GET |
/oauth/callback |
Callback de MP |
| GET |
/oauth/validate |
Validar API key |
Cliente (API key o admin + ?client=)
| Método |
Ruta |
Descripción |
| GET |
/oauth/status |
Estado de autenticación |
| POST |
/oauth/refresh |
Renovar token |
| POST |
/oauth/logout |
Cerrar sesión |
| GET |
/stores |
Listar sucursales |
| GET |
/stores/:id |
Detalle de sucursal |
| POST |
/stores |
Crear sucursal + POS |
| POST |
/stores/:id/pos |
Agregar POS |
| DELETE |
/stores/:id/pos/:posId |
Eliminar POS |
| DELETE |
/stores/:id |
Eliminar sucursal |
| GET |
/terminals |
Listar terminales |
| PATCH |
/terminals/operating-mode |
Cambiar modo |
| POST |
/orders |
Crear orden |
| GET |
/orders/:idempotencyKey |
Estado de orden |
| POST |
/orders/cancel |
Cancelar orden |
| POST |
/orders/refund |
Reembolsar orden |
Admin (solo admin token)
| Método |
Ruta |
Descripción |
| GET |
/api-keys |
Listar API keys |
| POST |
/api-keys |
Crear API key |
| POST |
/api-keys/revoke |
Revocar API key |
| GET |
/admin/clients/:name |
Info del cliente |
| GET |
/admin/webhooks/logs |
Webhook logs |
| GET |
/admin/activity |
Activity logs |
| POST |
/admin/orders/:key/simulate |
Simular evento |
Webhooks (signature HMAC)
| Método |
Ruta |
Descripción |
| POST |
/webhooks |
Receptor de webhooks MP |
Éxito
{
"message": "Order created successfully",
"order_id": "ORD...",
"status": "created"
}
Error de validación (422)
{
"error": "Validation failed",
"code": "VALIDATION_ERROR",
"details": [
{ "path": "amount", "message": "Required" }
]
}
Error general
{
"error": "Client 'test' not found",
"code": "NOT_FOUND"
}
Montos
El ERP envía montos con coma como separador decimal:
La API convierte internamente a punto para MercadoPago: