Comandos
El Mercado Pago CLI disponibiliza comandos para operar nuestros principales productos integrables directamente desde la terminal. Consulta los comandos disponibles por producto, cómo utilizarlos y la referencia completa de cada uno.
Comandos por producto
| Comando | Disponibilidad por producto(s) |
mp payments, mp cards | Checkout API |
mp preferences | Checkout Pro |
mp orders | Checkout Pro Checkout API |
mp merchant-orders | Marketplace |
mp subscriptions, mp subscription-plans | Suscripciones |
mp pos, mp stores | Point código QR |
mp chargebacks | Todos los productos. |
mp reports releases, mp reports settlements | Todos los productos. |
mp oauth | Todos los productos. |
Cómo usar los comandos
Todos los comandos del CLI siguen el patrón mp [recurso] [acción] [flags]. Puedes consultar las opciones disponibles de cualquier comando utilizando la flag --help:
bash
mp --help mp payments --help
Formato de salida
De forma predeterminada, todos los comandos retornan un JSON:
bash
mp payments list # { "status": "success", "data": { "results": [...] } }
Para una salida tabular legible, utiliza la flag --table. A continuación se muestra un ejemplo:
bash
$ mp payments list --table ID STATUS AMOUNT METHOD DATE 12345678 approved $ 99.90 account_money 2025-01-01T...
Flags globales
Cualquier comando acepta los siguientes flags para controlar el formato de salida, autenticación o determinado comportamiento interactivo. Conoce más sobre cada uno de ellos:
| Flag | Atajo | Descripción |
--table | — | Salida tabular formateada. |
--silent | -s | Suprimir spinners y colores ANSI. |
--verbose | -v | Mostrar headers HTTP. |
--profile | -p | Perfil de credenciales a usar. |
--idempotency-key | — | Clave de idempotencia para POST/PUT. |
--data | — | Cuerpo de la solicitud mediante archivo JSON (@payload.json). |
--no-interactive | — | Deshabilitar prompts (CI/CD). |
--no-color | — | Deshabilitar salida con color. |
Exit codes
En scripts y pipelines, el Mercado Pago CLI retorna un código de salida al final de cada ejecución. Usa estos valores para gestionar errores de forma programática:
| Código | Significado |
0 | Éxito. |
1 | Error general. |
2 | Error de autenticación. |
3 | Error de validación. |
4 | Rate limit. |
mp docs [producto] — por ejemplo, mp docs payments.