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) |
mpcli payments, mpcli cards | Checkout Transparente |
mpcli advanced-payments | Checkout Transparente |
mpcli preferences | Checkout Pro |
mpcli orders | Checkout Pro Checkout Transparente |
mpcli merchant-orders | Marketplace |
mpcli subscriptions, mpcli subscription-plans | Suscripciones |
mpcli pos, mpcli stores | Point QR code |
mpcli shipping | Envíos |
mpcli chargebacks | Todos los productos. |
mpcli reports releases, mpcli reports settlements | Todos los productos. |
mpcli oauth | Todos los productos. |
Cómo usar los comandos
Todos los comandos del CLI siguen el patrón mpcli [recurso] [acción] [flags]. Puedes consultar las opciones disponibles de cualquier comando utilizando la flag --help:
bash
mpcli --help mpcli payments --help
Formato de salida
De forma predeterminada, todos los comandos retornan un JSON:
bash
mpcli payments list # { "status": "success", "data": { "results": [...] } }
Para una salida tabular legible, utiliza la flag --table. A continuación se muestra un ejemplo:
text
$ mpcli 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. Consulta los detalles de cada uno a continuación:
| 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. |
mpcli docs [producto] — por ejemplo, mpcli docs payments.