Este endpoint permite capturar en su totalidad una order previamente autorizada. Cada pago asociado se capturará en su totalidad. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
POST
REQUERIDO
REQUERIDO
REQUERIDO
Errores
Cada respuesta de la API incluye un código de estado HTTP que indica el resultado de la solicitud. El código 200 indica que la operación fue exitosa, el 400 señala un error en los datos enviados y el 500 indica un error interno del servidor.
Algunos errores 400 pueden gestionarse de forma programática e incluyen un código que describe la causa del error.
400Error de solicitud.
empty_required_header
El header "X-Idempotency-Key" es requerido y no fue enviado. Vuelve a realizar la requisición incluyéndolo.
invalid_idempotency_key_length
El valor enviado en el header "X-Idempotency-Key" excedió el tamaño máximo permitido. El header acepta valores entre 1 y 64 caracteres.
invalid_path_param
El "order_id" proporcionado en el path de la requisición no es correcto. Compruébalo y proporciona un ID válido para volver a intentarlo.
401Error. Access Token no autorizado.
401
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.
invalid_credentials
No hay soporte para credenciales de prueba. Use usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y sus credenciales de producción para el entorno de producción.
402Error de procesamiento.
402
La order fue creada pero alguna transacción ha fallado. Consulte el campo "errores" para obtener más información.
404Error. Order no encontrada.
order_not_found
Order no encontrada. Comprueba si enviaste el 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 requisición enviando un nuevo valor.
cannot_capture_order
Error. Order no puede ser capturada. El estado de la order no permite su captura. Solo pueden ser capturadas orders con "status=action_required" y "status_detail=waiting_capture".
operation_not_supported
La operación no es soportada para esta order. Comprueba el "status" y "status_detail" de la order e intenta nuevamente.
429Demasiadas solicitudes.
usage_quota_exceeded
Límite de solicitudes por cliente alcanzado. Lee el header "Retry-After" de la respuesta y espera la cantidad de segundos indicada antes de volver a intentarlo. Para mayor resiliencia, implementa backoff exponencial con jitter, es decir, aumenta el tiempo de espera en cada nuevo intento y añade una variación aleatoria para evitar el reenvío simultáneo de muchas solicitudes.
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*********932064-12*********edf6d3c99*********2236c703f*********668' \
-H 'X-Idempotency-Key: b2564442-e0dd-4785-84be-7eb991ace2c9' \
{
"id": "ORD01J49MMW3SSBK5PSV3DFR32959",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"payments": [
{
"id": "PAY01J49MMW3SSBK5PSV3DFR32959",
"amount": "25",
"status": "processed",
"status_detail": "accredited",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9"
}
]
}
}