API Reference - Mercado Pago Developers

Recursos para IA

Checkout Pro Checkout Pro redirige al comprador a un ambiente de Mercado Pago para que complete el pago. Puedes integrarlo mediante la API de Orders (flujo moderno) o la API de Preferencias (flujo clásico). Esta referencia describe los endpoints disponibles y cómo interactuar con ellos. ¿Buscas los pasos de integración? Ir a la documentación de Checkout Pro via Orders o Checkout Pro clásico.

¿Qué camino de integración usar? Elige según tu caso de uso.

Vía Orders API (Recomendada)

Flujo simplificado con un solo endpoint
checkout_url directo para redirigir al comprador
Nuevas funcionalidades y notificaciones simplificadas

Vía Preferences API (Legacy)

Flujo basado en preferencias e init_point
Compatible con integraciones existentes

Este camino de integración no es el recomendado. La API de Preferencias continuará siendo soportada, pero las nuevas funcionalidades estarán disponibles únicamente en la API de Orders. Si estás comenzando una integración nueva, usa Orders API. Si ya tienes una integración con Preferencias, consulta la documentación de Checkout Pro via Orders para planificar la migración.

Endpoints disponibles

Todos los endpoints que componen la integración de Checkout Pro vía Preferences.

Preferencias

La preferencia es el objeto central del flujo clásico de Checkout Pro. Define los ítems, montos, medios de pago habilitados y URLs de retorno del comprador.

Operación	Path	Descripción
Crear preferenciaPOST	`/checkout/preferences`	Crea una preferencia con ítems, precios y `back_urls`; devuelve el `init_point` para redirigir al comprador.
Buscar en preferenciasGET	`/checkout/preferences/search`	Busca preferencias por filtros como `external_reference` o fecha; devuelve resultados paginados.
Obtener preferenciaGET	`/checkout/preferences/{id}`	Obtiene el detalle de una preferencia: `init_point`, ítems y `back_urls` configuradas.
Actualizar preferenciaPUT	`/checkout/preferences/{id}`	Actualiza una preferencia existente antes de que el comprador complete el pago.

Pagos

Endpoints de lectura para verificar el estado de un pago tras recibir la notificación webhook o el redirect de retorno.

Operación	Path	Descripción
Buscar en pagosGET	`/v1/payments/search`	Busca pagos por filtros como `external_reference`, estado o fecha; devuelve resultados paginados.
Obtener pagoGET	`/v1/payments/{id}`	Obtiene el estado y detalle del pago, incluido `status_detail`, para confirmar el resultado tras la notificación.

Medios de pago

Operación	Path	Descripción
Obtener medios de pagoGET	`/v1/payment_methods`	Lista los medios de pago disponibles para el sitio, para incluirlos o excluirlos en la preferencia.

Contracargos

Operación	Path	Descripción
Obtener contracargoGET	`/v1/chargebacks/{id}`	Busca un caso de contracargo a partir de su ID devuelto en el body de la notificación configurada para contracargos. Devuelve el detalle de un contracargo: el status de la disputa, el monto afectado y el plazo para responder.
Buscar contracargosGET	`/v1/chargebacks/search`	Busca todos los contracargos de un pago por su "payment_id" devuelto en el body de la notificación configurada para contracargos. La búsqueda devuelve resultados paginados con el detalle de cada caso.
Enviar documentación probatoriaPOST	`/v1/chargebacks/{id}/documentation`	Sube archivos de evidencia para disputar un contracargo mientras su status ("documentation_status") sea "pending".
Obtener archivo de documentación probatoriaGET	`/v1/chargebacks/documentation/{type}/{uuid}`	Descarga o renderiza en línea un archivo de documentación subido para un caso de contracargo.