Este endpoint captura una order Wallet Connect previamente autorizada, donde solo se admite capturar el monto total. Solo aplica a orders creadas con capture_mode=manual y que están en status=action_required y status_detail=waiting_capture. Tras la captura, la order pasará a status=processed y status_detail=accredited. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
POST
REQUERIDO
REQUERIDO
REQUERIDO
400Error de solicitud.
empty_required_header
El header X-Idempotency-Key es requerido y no fue enviado. Vuelve a realizar la solicitud incluyéndolo.
invalid_idempotency_key_length
El X-Idempotency-Key debe tener entre 1 y 64 caracteres.
invalid_path_param
El order_id proporcionado en el path no es válido. Compruébalo y proporciona un order_id válido para volver a intentarlo.
401Error. Access Token no autorizado.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la petición enviando el valor correcto.
invalid_credentials
No hay soporte para credenciales de prueba. Utiliza usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y tus credenciales de producción para el entorno de producción.
404Recurso no encontrado.
order_not_found
Order no encontrada. Comprueba si enviaste el order_id correcto.
payment_not_found
Pago no encontrado. Comprueba si enviaste el payment_id correcto.
409Alguna regla específica del sistema no permite realizar la acción debido a restricciones definidas.
idempotency_key_already_used
El valor enviado como header de idempotencia (X-Idempotency-Key) ya fue utilizado. Por favor, vuelve a intentar realizar la solicitud enviando un nuevo valor.
cannot_capture_order
La order no puede ser capturada porque no está en un estado que permita la captura. Solo las orders en estado action_required con capture_mode=manual pueden ser capturadas.
operation_not_supported
La operación no es soportada para esta order. Comprueba el status y status_detail de la order e intenta nuevamente.
500Error genérico.
idempotency_validation_failed
Falla en la validación de idempotencia. Intenta enviar la solicitud nuevamente.
internal_error
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-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Idempotency-Key: 40e4b84a-1a15-4847-a3c2-64f0ca947faf' \
{
"id": "ORDBTA01KHY4WFPYXJ9Z7S5CGED7WCTP",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"payments": [
{
"id": "PAY01KSND6GMT3KAG0Z2TB9M8B0WW",
"amount": "50.50",
"paid_amount": "50.50",
"status": "processed",
"status_detail": "accredited",
"reference_id": "ref-capture"
}
]
}
}