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.

Crear order - Pagos presenciales - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Crear order

POST

https://api.mercadopago.com/v1/orders
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.
Parámetros para la solicitud
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
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.
type_config
object

REQUERIDO

Configuración del tipo de order.
Parámetros de respuesta
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.
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 o servicio 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.

required_properties

Ciertas propiedades requeridas están ausentes. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

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.

Solicitud
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 TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    -d '{
  "type": "point",
  "external_reference": "ext_ref_1234",
  "transactions": {
    "payments": [
      {
        "amount": "24.90"
      }
    ]
  },
  "type_config": {
    "terminal_id": "PAX_A910__SMARTPOS1423",
    "ticket_number": "S0392JED",
    "flow_process": "credit_card"
  },
  "description": "Point Mini",
  "integration_data": {
    "platform_id": "1234567890",
    "integrator_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  }
}'
Respuesta de ejemplo
{
  "id": "123",
  "type": "point",
  "external_reference": "ext_ref_1234",
  "description": "Point Mini",
  "site_id": "MLB",
  "integration_data": {
    "application_id": 1234567890,
    "platform_id": "1234567890",
    "integrator_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "status": "created",
  "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": "created"
      }
    ]
  }
}