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 presenciales - 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 creada para Mercado Pago Point 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 "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 orden a cancelar. Este valor es devuelto en la respuesta a la peticiĂłn Crear order.
HEADER
X-Idempotency-Key
string

REQUERIDO

Esta funciĂłn permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acciĂłn mĂĄs de una vez por error. Esto es Ăștil para evitar errores, como la creaciĂłn de dos pagos idĂ©nticos. Para garantizar qu...Ver mĂĄs
ParĂĄmetros de respuesta
id
string
Identificador de la order cancelada en la solicitud.
type
string
Tipo de order.
point: Order creada para pagos con Mercado Pago Point.
external_reference
string
Es una referencia externa de la order, asignada al momento de su creaciĂłn. El lĂ­mite mĂĄximo permitido es de 64 caracteres y los permitidos son: letras mayĂșsculas y minĂșsculas, nĂșmeros y los sĂ­mbolos de guion (-) y guion ...Ver mĂĄs
description
string
DescripciĂłn del producto comprado, el motivo de la order de pago.
Errores

400Error.

empty_required_header

El header 'X-Idempotency-Key' es requerido y no fue enviado. Vuelve a realizar la petición incluyéndolo.

invalid_path_param

El order_id proporcionado en el path de la petición no es correcto. Compruébalo y proporciona un ID vålido para volver a intentarlo.

401Error.

unauthorized

El valor enviado como Access Token es incorrecto. Por favor, verifĂ­calo y vuelve a intentar realizar la peticion enviando el valor correcto.

404Error.

order_not_found

Order no encontrada. Comprueba si enviaste el ID correcto.

409Error.

idempotency_key_already_used

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

cannot_cancel_order

Hay un conflicto al intentar cancelar la order por su estado actual. Recuerda que las orders solo pueden ser canceladas vĂ­a API cuando "status=created". Si estĂĄs intentando cancelar una order con estado "status=at_terminal", deberĂĄs hacerlo desde la terminal.

500Error.

idempotency_validation_failed

Falla en la validaciĂłn de idempotencia. Intenta enviar la solicitud nuevamente.

500

Error interno. Intenta enviar la solicitud nuevamente.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/cancel'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    
Respuesta de ejemplo
{
  "id": "123",
  "type": "point",
  "external_reference": "ext_ref_1234",
  "description": "Point Smart Mini",
  "site_id": "MLB",
  "integration_data": {
    "application_id": 1234567890,
    "platform_id": "1234567890",
    "integrator_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "status": "cancelled",
  "created_date": "2024-09-10T14:26:42.109320977Z",
  "last_updated_date": "2024-09-10T14:26:42.109320977Z",
  "type_config": {
    "terminal_id": "PAX_A910__SMARTPOS1423",
    "ticket_number": "S0392JED",
    "flow_process": "credit_card"
  },
  "transactions": {
    "payments": [
      {
        "id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24.90",
        "status": "cancelled",
        "status_detail": "cancelled_by_api"
      }
    ]
  }
}