Recursos para IA

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.

Para abrir la Referencia de API de cualquier producto directamente en el navegador, utiliza mpcli docs [producto] — por ejemplo, mpcli docs payments.

Referencia de comandos

Pagos

Gestiona el ciclo de vida de un pago, desde la creación hasta la captura, la cancelación y la actualización.

bash
mpcli payments list
mpcli payments get <id>
mpcli payments search --status approved
mpcli payments search --payment-method-id pix
mpcli payments search --external-reference "ORDER-001"
mpcli payments create --data @payment.json
mpcli payments cancel <id>
mpcli payments capture <id>
mpcli payments update <id> --data @update.json

Reembolsos

Consulta el historial y los detalles de reembolsos asociados a un pago y crea reembolsos totales o parciales. Es necesario informar el ID del pago original para utilizar este comando.

bash
mpcli refunds create <payment-id>
mpcli refunds create <payment-id> --amount 50.00
mpcli refunds list <payment-id>
mpcli refunds get <payment-id> <refund-id>

Pagos avanzados

Crea y gestiona flujos de pago avanzados con pagos divididos y desembolsos.

bash
mpcli advanced-payments create --data @advanced_payment.json
mpcli advanced-payments get <id>
mpcli advanced-payments search --external-reference ORDER-001
mpcli advanced-payments update <id> --data @update.json
mpcli advanced-payments refund <id>
mpcli advanced-payments refund <id> --amount 100.00

Preferencias de pago en Checkout Pro

Crea y gestiona preferencias de pago que configuran el comportamiento del Checkout Pro en cada transacción.

bash
mpcli preferences list
mpcli preferences get <id>
mpcli preferences create --data @pref.json
mpcli preferences update <id> --data @pref.json

Clientes y tarjetas

Gestiona perfiles de clientes y sus tarjetas tokenizadas, habilitando cobros recurrentes y flujos de pago con datos guardados.

bash
mpcli customers list
mpcli customers get <id>
mpcli customers create --email user@example.com
mpcli customers update <id> --data @customer.json
mpcli customers delete <id>

Gestión de suscripciones

Crea y gestiona planes y suscripciones recurrentes para cobros periódicos. Consulta la documentación de planes de suscripción para más información.

bash
mpcli subscriptions list
mpcli subscriptions get <id>
mpcli subscriptions create --data @subscription.json
mpcli subscriptions update <id> --data @sub.json

Tiendas y Puntos de venta (PDV)

Crea y configura tiendas físicas y puntos de venta (PDV) para procesar pagos presenciales con Point y QR Code. Consulta la documentación de QR Code para más detalles sobre el procesamiento de pagos con orders.

bash
mpcli stores search
mpcli stores get <id>
mpcli stores create --name "Tienda Principal" --external-id MI_TIENDA
mpcli stores update <id> --data @store.json
mpcli stores delete <id>

Orders

Merchant Orders

Agrupa pagos y envíos en flujos de Marketplace. Requiere integración con Marketplace configurada.

bash
mpcli merchant-orders create --preference-id <preference-id>
mpcli merchant-orders create --data @order.json
mpcli merchant-orders get <id>
mpcli merchant-orders search --external-reference "REF-001"
mpcli merchant-orders update <id> --data @update.json

Envíos

Crea y realiza el seguimiento de envíos asociados a pedidos.

bash
mpcli shipping create --data @shipment.json
mpcli shipping get <id>
mpcli shipping list
mpcli shipping cancel <id>
mpcli shipping track <id>

Contracargos

Consulta y realiza el seguimiento de los contracargos abiertos contra cobros realizados por tu integración.

bash
mpcli chargebacks list
mpcli chargebacks get <id>
mpcli chargebacks search --payment-id <payment-id>

Reportes financieros

Genera y consulta reportes financieros de liberaciones y dinero en cuenta para la conciliación y auditoría de transacciones. Consulta la documentación de reportes para más información.

El módulo de Reportes financieros debe estar habilitado en la cuenta de Mercado Pago.

Consulta los comandos disponibles por tipo de reporte:

bash
mpcli reports releases list
mpcli reports releases create --date-from 2025-01-01 --date-to 2025-01-31

Métodos de pago y Tipos de identificación

OAuth

Gestiona el intercambio de códigos de autorización y la renovación de tokens de acceso mediante OAuth 2.0. Consulta la documentación de OAuth para más información.

bash
mpcli oauth url --client-id <id> --redirect-uri https://miapp.com/callback
mpcli oauth token --client-id <id> --client-secret <secret> --code <code> --redirect-uri https://miapp.com/callback
mpcli oauth refresh --token <refresh-token>

Config

Gestiona perfiles de credenciales con nombre para cambiar entre cuentas y entornos sin necesidad de reautenticarse.

bash
mpcli config set --profile sandbox --token TEST-... --environment sandbox
mpcli config use sandbox
mpcli config list
mpcli config get environment

Sandbox y pruebas

Crea y configura usuarios de prueba, saldo virtual y tarjetas de prueba para simular escenarios de pago en entorno de sandbox.

Crear usuario de prueba

bash
mpcli tester create

Definir saldo virtual

bash
mpcli tester balance set --user-id <id> --amount 10000

Provisionar tarjeta de prueba

El --scenario define el comportamiento simulado:

bash
mpcli tester card create --user-id <id> --scenario approved
mpcli tester card create --user-id <id> --scenario insufficient_funds
mpcli tester card create --user-id <id> --scenario stolen_card
mpcli tester card create --user-id <id> --scenario high_risk

Escenario	Comportamiento
`approved`	Tarjeta siempre aprobada.
`insufficient_funds`	Rechazada por saldo insuficiente.
`stolen_card`	Rechazada por código de seguridad inválido.
`high_risk`	Entra en revisión de fraude.

AnteriorInstalar Mercado Pago CLIInstala el MP CLI vía Homebrew y autentícate con tu token de acceso.

PróximoNuvemshopMercado Pago en tu tienda.