Recursos para IA
Checkout API
Checkout API permite procesar pagos directamente en tu sitio o app, sin redirigir al comprador a una página externa. Admite tarjetas de crédito y débito, efectivo y otros medios de pago locales. 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 API.
¿Qué camino de integración usar?
Elige según tu caso de uso.
- Procesamiento automático y manual
- Captura diferida de fondos
- Nuevas funcionalidades y notificaciones simplificadas
- Procesamiento automático
- Captura diferida de fondos
Vía Orders API (Recomendada)
Vía Payments API (Legacy)
Endpoints disponibles
Todos los endpoints que componen la integración de Checkout API vía Orders.
| Operación | Path | Descripción |
| Crear orderPOST | /v1/orders | Crea una nueva order en modo automatic (pago en un paso) o manual (autorizar y capturar por separado); devuelve el order_id. |
| Capturar order completamentePOST | /v1/orders/{id}/capture | Captura el monto completo de una order en modo manual; solo válido para tarjetas de crédito. |
| Agregar transacciones a la orderPOST | /v1/orders/{id}/transactions | Agrega una transacción a una order en modo manual con card_token, installments y payment_method_id. |
| Eliminar una transacción de la orderDELETE | /v1/orders/{id}/transactions/{transaction_id} | Elimina una transacción antes de llamar a /process, para corregir el medio de pago o el monto en modo manual. |
| Actualizar una transacción de la orderPUT | /v1/orders/{id}/transactions/{transaction_id} | Actualiza los datos de una transacción existente en una order en modo manual. |
| Procesar order por IDPOST | /v1/orders/{id}/process | Dispara la autorización del pago; la order transiciona a approved, pending, rejected o failed. |
| Buscar orderGET | /v1/orders/search | Busca orders por filtros como fecha, estado o external_reference; devuelve resultados paginados. |
| Obtener order por IDGET | /v1/orders/{id} | Obtiene el estado y detalle completo de la order, incluidas sus transacciones y el processing_mode activo. |
| Cancelar order por IDPOST | /v1/orders/{id}/cancel | Cancela una order antes de procesarla o cuando el pago resultó rechazado o pendiente. |
| Reembolsar una orderPOST | /v1/orders/{id}/refund | Reembolsa una order total o parcialmente. |
| Operación | Path | Descripción |
| Obtener medios de pagoGET | /v1/payment_methods | Lista los medios de pago disponibles para el sitio (tarjetas, tickets, wallets, etc.) para mostrar las opciones en el checkout. |
| Operación | Path | Descripción |
| Obtener tipos de documentosGET | /v1/identification_types | Lista los tipos de documento disponibles por país para completar el formulario del pagador. |
Endpoints para guardar y gestionar tarjetas de clientes. Útiles para reducir la fricción en compras recurrentes.
| Operación | Path | Descripción |
| Guardar tarjetaPOST | /v1/customers/{customer_id}/cards | Asocia una tarjeta tokenizada a un cliente a partir de un card_token generado con MercadoPago.js. |
| Obtener tarjetas de un clienteGET | /v1/customers/{customer_id}/cards | Lista las tarjetas tokenizadas guardadas para un cliente. |
| Obtener tarjetaGET | /v1/customers/{customer_id}/cards/{card_id} | Obtiene los datos de una tarjeta guardada: últimos 4 dígitos, marca y fecha de vencimiento. |
| Actualizar tarjetaPUT | /v1/customers/{customer_id}/cards/{card_id} | Actualiza los datos de una tarjeta tokenizada guardada. |
| Eliminar tarjetaDELETE | /v1/customers/{customer_id}/cards/{card_id} | Elimina una tarjeta guardada del cliente. |
Endpoints para crear y gestionar perfiles de clientes y guardar sus medios de pago.
| Operación | Path | Descripción |
| Crear clientePOST | /v1/customers | Registra un cliente cuyo customer_id es necesario para gestionar sus tarjetas y direcciones. |
| Buscar en clientesGET | /v1/customers/search | Busca clientes por email u otros filtros; devuelve resultados paginados. |
| Obtener clienteGET | /v1/customers/{id} | Obtiene los datos del cliente, incluyendo medios de pago guardados y metadata. |
| Actualizar clientePUT | /v1/customers/{id} | Actualiza los datos de un cliente. |
Endpoints para gestionar las direcciones asociadas a los clientes.
| Operación | Path | Descripción |
| Crear direcciónPOST | /v1/customers/{customer_id}/addresses | Registra una dirección de envío para el cliente. |
| Listar direccionesGET | /v1/customers/{customer_id}/addresses | Lista las direcciones de envío guardadas para un cliente. |
| Obtener direcciónGET | /v1/customers/{customer_id}/addresses/{address_id} | Obtiene el detalle de una dirección de envío guardada. |
| Actualizar direcciónPUT | /v1/customers/{customer_id}/addresses/{address_id} | Actualiza los datos de una dirección de envío guardada. |
| Eliminar una direcciónDELETE | /v1/customers/{customer_id}/addresses/{address_id} | Elimina una dirección de envío del cliente. |
| 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. |
¿Todo listo para empezar?
Ve al primer endpoint y empieza a construir tu flujo de pagos con la API de Orders.