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.

Cancelar order por ID - Pagos online - Mercado Pago Developers

BĂșsqueda inteligente powered by OpenAI 

Cancelar order por ID

POST

https://api.mercadopago.com/v1/orders/{order_id}/cancel
Cancela una order y sus transacciones utilizando el ID de referencia obtenido en la respuesta a su creaciĂłn. SĂłlo puede ser cancelada una order en status "action_required" o "created". 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 cancelar. Este valor es devuelto en la respuesta a la requisiciĂłn Crear order.
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. ID invĂĄlido.

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.

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.

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

Error. Order ya cancelada.

Alguna regla especĂ­fica del sistema no permite realizar la acciĂłn debido a restricciones definidas.

500Error genérico.

internal_error

Error genérico. Intenta enviar la solicitud nuevamente.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/cancel'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-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": "canceled",
  "status_detail": "canceled_transaction",
  "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": "canceled",
        "status_detail": "canceled_transaction",
        "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"
}