Recursos para IA
Checkout Pro
Checkout Pro redirige al comprador a un ambiente de Mercado Pago para que complete el pago. El flujo se centra en la creación de preferencias desde tu backend. 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.
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. |
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. |
Las órdenes comerciales agrupan todas las transacciones asociadas a una preferencia. Útiles para conciliación y seguimiento multi-pago.
| Operación | Path | Descripción |
| Buscar en órdenes comercialesGET | /merchant_orders/search | Busca órdenes comerciales por filtros como preference_id o external_reference; devuelve resultados paginados. |
| Obtener orden comercialGET | /merchant_orders/{id} | Obtiene el detalle de una orden comercial: pagos asociados, monto total recibido y estado de cada transacción. |
| Actualizar orden comercialPUT | /merchant_orders/{id} | Actualiza los datos de una orden comercial existente. |
| 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. |
| Operación | Path | Descripción |
| Crear cancelaciónPUT | /v1/payments/{id} | Cancela un pago pendiente antes de que sea procesado. |
| Operación | Path | Descripción |
| Crear reembolsoPOST | /v1/payments/{id}/refunds | Crea un reembolso total o parcial; para reembolso parcial, incluir amount en el body. |
| Obtener lista de reembolsosGET | /v1/payments/{id}/refunds | Lista los reembolsos de un pago; devuelve el monto, la fecha y el estado de cada uno. |
| Obtener reembolso específicoGET | /v1/payments/{id}/refunds/{refund_id} | Obtiene el detalle de un reembolso: monto procesado, fecha y estado. |
| Operación | Path | Descripción |
| Obtener contracargoGET | /v1/chargebacks/{id} | Obtiene el detalle de un contracargo: estado de la disputa, monto afectado y plazo para responder. |
SDKs
Usa nuestros SDKs oficiales para integrar Checkout Pro más rápido. GitHub es la fuente de verdad de cada librería.
¿Todo listo para empezar?
Ve al primer endpoint y empieza a crear tu primera preferencia de pago.