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. Se integra mediante la API de preferencias. 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.

Endpoints disponibles

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

Preferencias

La preferencia es el objeto central 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.