Inicio
Documentación
Recursos
Certificaciones
Comunidad

Recursos

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

Comunidad

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

Procesar order por ID - Pagos online - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Procesar order por ID

POST

https://api.mercadopago.com/v1/orders/{order_id}/process
Realiza el procesamiento de una order y sus transacciones asociadas utilizando el ID de referencia obtenido en la respuesta a su creación. 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 a procesar. Este valor es devuelto en la respuesta a la requisición 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 creada en la solicitud, generado automáticamente por Mercado Pago.
processing_mode
string
Modo de procesamiento de la order
manual: El procesamiento de la order se hará de manera manual. Es el modo de procesamiento utilizado para la opción "manual", en tanto configura que el procesamiento sea hecho posteriormente, utilizando el endpoint "Procesar Order por ID".
automatic: El procesamiento de la order se hará instantáneamente. Es el modo de procesamiento utilizado para la opción "automático".
external_reference
string

REQUERIDO

Es una referencia externa de la order. Puede ser, por ejemplo, un hashcode del Banco Central, funcionando como identificador de origen de la transacción. Este campo debe tener como máximo 64 caracteres y estos solo puede...Ver más
total_amount
string
Monto total a pagar. Debe ser enviado con dos números decimales.
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.

invalid_total_amount

El valor ingresado en "total_amount" no es equivalente a la suma del campo "transactions.payments.amount" del total de las transacciones. Por favor, verifica que los valores sean correctos.

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.

idempotency_key_already_used

El valor enviado como header de idempotencia ya fue utilizado. Por favor, vuelve a intentar realizar la requisición enviando un nuevo valor.

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}/process'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    
Respuesta de ejemplo
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "total_amount": "24.90",
  "integration_data": {
    "application_id": "1234",
    "integrator_id": "dev_123",
    "platform_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "user_id": "12345",
  "created_date": "2024-08-26T13:06:51.045317772Z",
  "last_updated_date": "2024-08-26T13:06:51.045317772Z",
  "country_code": "BRA",
  "type": "online",
  "status": "processed",
  "status_detail": "accredited",
  "capture_mode": "manual",
  "payer": {
    "email": "test@test.com",
    "first_name": "John",
    "last_name": "Doe",
    "identification": {
      "type": "CPF",
      "number": "99999999999"
    },
    "phone": {
      "area_code": "11",
      "number": "987654321"
    },
    "address": {
      "zip_code": "12345678",
      "street_name": "Rua Teste",
      "street_number": "123"
    }
  },
  "transactions": {
    "payments": [
      {
        "id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24.90",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "status": "processed",
        "status_detail": "accredited",
        "payment_method": {
          "id": "visa",
          "type": "credit_card",
          "token": "12345",
          "installments": 1,
          "statement_descriptor": "approved"
        }
      }
    ]
  },
  "description": "Point Mini",
  "marketplace": "MERCADOLIVRE",
  "items": [
    {
      "title": "Point Mini",
      "unit_price": "12.90",
      "quantity": 4,
      "description": "Point product for card payments via Bluetooth.",
      "id": "1234",
      "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
      "category_id": "MLB1055"
    }
  ],
  "expiration_time": "P3Y6M4DT12H30M5S"
}