Comandos
O Mercado Pago CLI disponibiliza comandos para operar nossos principais produtos integráveis diretamente pelo terminal. Confira os comandos disponíveis por produto, como utilizá-los e a referência completa de cada um.
Comandos por produto
| Comando | Disponibilidade por produto(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 | Assinaturas |
mp pos, mp stores | Point código QR |
mp chargebacks | Todos os produtos. |
mp reports releases, mp reports settlements | Todos os produtos. |
mp oauth | Todos os produtos. |
Como usar os comandos
Todos os comandos do CLI seguem o padrão mp [recurso] [ação] [flags]. Você pode consultar as opções disponíveis de qualquer comando utilizando a flag --help:
bash
mp --help mp payments --help
Formato de saída
Por padrão, todos os comandos retornam um JSON:
bash
mp payments list # { "status": "success", "data": { "results": [...] } }
Para uma saída tabular legível, utilize a flag --table. Confira um exemplo a seguir:
bash
$ mp payments list --table ID STATUS AMOUNT METHOD DATE 12345678 approved $ 99.90 account_money 2025-01-01T...
Flags globais
Qualquer comando aceita as seguintes flags para controlar o formato de saída, autenticação ou determinado comportamento interativo. Entenda melhor cada uma delas:
| Flag | Atalho | Descrição |
--table | — | Saída tabular formatada. |
--silent | -s | Suprimir spinners e cores ANSI. |
--verbose | -v | Exibir headers HTTP. |
--profile | -p | Perfil de credenciais a usar. |
--idempotency-key | — | Chave de idempotência para POST/PUT. |
--data | — | Corpo da requisição via arquivo JSON (@payload.json). |
--no-interactive | — | Desabilitar prompts (CI/CD). |
--no-color | — | Desabilitar saída colorida. |
Exit codes
Em scripts e pipelines, o Mercado Pago CLI retorna um código de saída ao final de cada execução. Use esses valores para tratar erros de forma programática:
| Código | Significado |
0 | Sucesso. |
1 | Erro geral. |
2 | Erro de autenticação. |
3 | Erro de validação. |
4 | Rate limit. |
mp docs [produto] — por exemplo, mp docs payments.