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-7434*********159-03141*********cee51edf8*********f94f589-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"
      }
    ]
  }
}