Disponible únicamente para terminales configuradas en modo PDV, este endpoint permite capturar — total o parcialmente — una order de Mercado Pago Point previamente autorizada en modo reserva de pago, que se activa al crear una order POST /v1/orders en modo manual (processing_mode=manual). La funcionalidad de autorización y captura en dos etapas debe habilitarse previamente en tu cuenta por el equipo comercial de Mercado Pago. Contacta a tu asesor comercial para solicitar la activación. Para una captura total de la order, envía el body vacío y, para una captura parcial, envía el array transactions.payments con el ID del pago y el monto a capturar. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
POST
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO CONDICIONAL
400Error.
empty_required_header
El header X-Idempotency-Key es requerido y no fue enviado. Vuelve a realizar la solicitud incluyéndolo.
bad_request
El order_id proporcionado en el path de la solicitud no es correcto. Verifícalo y proporciona un ID válido para intentarlo de nuevo.
unsupported_properties
El body de la solicitud contiene propiedades no soportadas. Para captura total, envía el body vacío. Para captura parcial, solo se aceptan las propiedades transactions.payments.id y transactions.payments.amount.
401Credenciales inválidas.
unauthorized
El valor enviado como Access Token es incorrecto. Verifícalo e intenta realizar la solicitud de nuevo con el valor correcto.
404Order no encontrada.
order_not_found
Order no encontrada. Verifica si el ID enviado es correcto.
409Alguna regla específica del sistema no permite realizar la acción.
cannot_capture_order
La order no puede ser capturada. Solo pueden capturarse orders con status=action_required y status_detail=waiting_capture. Verifica el estado actual de la order antes de intentarlo de nuevo.
idempotency_key_already_used
El valor enviado como header de idempotencia (X-Idempotency-Key) ya fue utilizado en una solicitud diferente en un período de 24 horas. Por favor, intenta la solicitud nuevamente con un nuevo valor.
operation_not_supported
Esta operación no está soportada para la order en su estado actual. Verifica el status y el status_detail de la order.
422Entidad no procesable.
invalid_capture_amount
El monto de captura es inválido. Debe ser mayor a 0 y menor o igual al monto autorizado en la creación de la order. Verifica el monto a capturar e intenta de nuevo.
capture_exceeds_authorized
El monto de captura supera el monto autorizado. El monto a capturar no puede ser mayor al monto autorizado en la creación de la order. Ajusta el monto e intenta de nuevo.
500Error genérico.
idempotency_validation_failed
Falla en la validación de idempotencia. Intenta enviar la solicitud nuevamente.
500
Error genérico. Intenta enviar la solicitud nuevamente.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/capture'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Idempotency-Key: 6341663c-d238-44be-9e5c-a39b30b2732e' \
-d '{
"transactions": {
"payments": [
{
"id": "PAY01ABCDEFGHIJKLMNOPQRSTUVWX",
"amount": "35.00"
}
]
}
}'{
"id": "ORD01ABCDEFGHIJKLMNOPQRSTUVWX",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"payments": [
{
"id": "PAY01ABCDEFGHIJKLMNOPQRSTUVWX",
"amount": "1500.00",
"paid_amount": "35.00",
"status": "processed",
"status_detail": "accredited"
}
]
}
}