Crear order - Orders - Mercado Pago Developers
Crear order

Este endpoint permite crear una order para Mercado Pago Point para transacciones de pago. En caso de éxito, la solicitud devolverá una respuesta con el estado 201

POST

https://api.mercadopago.com/v1/orders
Request parameters
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
Body
type
string

REQUERIDO

Tipo de order, asociado a la solución de Mercado Pago para la que se crea. Para pagos con Mercado Pago Point, el único valor posible es "point".
point: Valor asociado a la creación de orders para pagos con Mercado Pago Point.
external_reference
string

REQUERIDO

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
expiration_time
string
Indica el **período de validez** de la order de pago a partir de su creación. Durante este tiempo, la order estará habilitada para ser procesada por el cliente; si la orden no se procesa dentro del plazo especificado, ex...Ver más
transactions
object

REQUERIDO

Contiene información sobre la transacción asociada a la order. Cuando el "type" es "point", solo es posible incluir 1 transacción por order.
Response parameters
id
string
Identificador de la order creada en la solicitud, generado automáticamente por Mercado Pago.
type
string
Tipo de order.
point: Order creada para pagos con Mercado Pago Point.
user_id
string
Identificador del usuario de Mercado Pago que creó la order.
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
Errors

400Error.

empty_required_header

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

required_properties

Algumas propiedades requeridas están ausentes. Verifique el mensaje devuelto en los detalles del error para identificar el problema y vuelva a intentarlo enviando la información faltante.

unsupported_properties

Se envió una propiedad que no es soportada. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

minimum_properties

No se envió el número mínimo de propiedades necesarias para ejecutar la solicitud. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

property_type

Se envió un tipo de propiedad incorrecto. Por ejemplo, un valor 'integer' para una propiedad 'string'. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

minimum_items

No se envió el número mínimo de ítems para alguna propiedad. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

maximum_items

Se envió una cantidad mayor de ítems que la permitida para alguna propiedad. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

property_value

Se envió un valor inválido para alguna propiedad. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

json_syntax_error

Se envió un JSON inválido. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

401Error.

unauthorized

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la petición enviando el valor correcto.

403Error.

forbidden_checking_terminal_owner

La terminal Point no pertence al usuario que envió la solicitud. Verifica si el valor enviado para "terminal_id" es correcto o si la terminal está vinculado a tu cuenta.

409Error.

idempotency_key_already_used

El valor enviado como header de idempotencia ya fue utilizado con una solicitud distinta en un tiempo menor a 24 horas. Por favor, vuelve a intentar realizar la petición enviando un nuevo valor.

already_queued_order_for_terminal

La terminal ya tiene una order en espera. Es necesario finalizarla o cancelarla para enviar nuevas orders.

500Error.

idempotency_validation_failed

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

500

Error genérico. Intenta enviar la solicitud nuevamente.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/orders'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer APP_USR-7*********635832-03*********2ffa6c013*********0a90fa2cd*********120' \
    -d '{
  "type": "point",
  "external_reference": "ext_ref_1234",
  "expiration_time": "PT16M",
  "transactions": {
    "payments": [
      {
        "amount": "25"
      }
    ]
  },
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB801293324",
      "print_on_terminal": "no_ticket",
      "ticket_number": "S0392JED"
    },
    "payment_method": {
      "default_type": "credit_card",
      "default_installments": 6
    }
  },
  "description": "Smartphone",
  "integration_data": {
    "platform_id": "dev_1234567890",
    "integrator_id": "dev_123456",
    "sponsor": {
      "id": "446566691"
    }
  },
  "taxes": [
    {
      "payer_condition": "payment_taxable_iva"
    }
  ]
}'
Response
{
  "id": "ORD00001111222233334444555566",
  "type": "point",
  "user_id": "5238400195",
  "external_reference": "ext_ref_1234",
  "description": "Smartphone",
  "expiration_time": "PT16M",
  "processing_mode": "automatic",
  "country_code": "CHL",
  "integration_data": {
    "application_id": "1234567890",
    "platform_id": "dev_1234567890",
    "integrator_id": "dev_123456",
    "sponsor": {
      "id": "446566691"
    }
  },
  "status": "created",
  "status_detail": "created",
  "created_date": "2024-09-10T14:26:42.109320977Z",
  "last_updated_date": "2024-09-10T14:26:42.109320977Z",
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB801293324",
      "print_on_terminal": "no_ticket",
      "ticket_number": "S0392JED"
    },
    "payment_method": {
      "default_type": "credit_card",
      "default_installments": "6"
    }
  },
  "transactions": {
    "payments": [
      {
        "id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24",
        "status": "created"
      }
    ]
  },
  "taxes": [
    {
      "payer_condition": "payment_taxable_iva"
    }
  ]
}