Inicio
Documentación
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integración y vendedores que quieren contratarlos.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Capturar order totalmente - Pagos online - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Capturar order completamente

POST

https://api.mercadopago.com/v1/orders/{order_id}/capture
Este endpoint permite capturar en su totalidad una order previamente autorizada. Cada payment asociado se capturará en su totalidad. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
Parámetros para la solicitud
PATH
order_id
string

REQUERIDO

ID de la order cuyos valores se capturarán. Este valor se devuelve en la respuesta a la solicitud de Crear order.
HEADER
X-Idempotency-Key
string

REQUERIDO

Esta función permite repetir requisiciones de forma segura, sin riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores como crear dos pagos idénticos. Para garantizar que cada solic...Ver más
Parámetros de respuesta
id
string
Identificador de la order procesada en la solicitud.
status
string
Estado actual de la order.
processed: Todas las transacciones fueron procesadas exitosamente.
processing: La order está siendo procesada y no necesita ninguna acción del integrador. Por ejemplo, es posible que el pago esté pendiente de revisión manual.
status_detail
string
Detalles sobre el estado del pago.
accredited: Pago acreditado.
in_process: Si status=processing, el pago está está siendo procesado.
transactions
object
Contiene información sobre las transacciones asociadas a una order.
Errores

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_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.

402Rrror de procesamiento.

402

La order fue creada pero alguna transacción ha fallado. Consulta 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.

Alguna regla específica del sistema no permite realizar la acción debido a restricciones definidas.

La order no puede ser capturada. Comprueba el estado de la order e intenta nuevamente.

Error. Operación no soportada.

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.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/capture'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
    
Respuesta de ejemplo
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "accredited",
  "transactions": {
    "payments": [
      {
        "id": "PAY01J49MMW3SSBK5PSV3DFR32959",
        "amount": "24.90",
        "status": "processed",
        "status_detail": "accredited",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9"
      }
    ]
  }
}