Inicio
Documentación
Recursos
Certificaciones
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear orden - Órdenes comerciales - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Crear orden

POST

https://api.mercadopago.com/merchant_orders
Genera una orden para asociarla a la preferencia de pago y obtén la URL necesaria para iniciar el flujo de pago.
Parámetros para la solicitud
BODY
external_reference
string
Identificador único que envía el vendedor para relacionar la order_id generada por Mercado Pago, con el id de su sistema de pagos
preference_id
string
Identificador de la preferencia de pago asociado a la orden
marketplace
string
Indica si es un pago de Marketplace de Mercado Libre (MELI) o Mercado Pago (NONE)
notification_url
string
URL a la cual te gustaría recibir notificaciones de pagos
Parámetros de respuesta
id
number
Identificador único de la orden generada por Mercado Pago
status
string
Muestra el estado actual de la orden
opened: Order without payments.
closed: Order with payments covering total amount.
expired: Canceled order that does not have approved or pending payments (all rejected or returned).
external_reference
string
Identificador único que envía el vendedor para relacionar la order_id generada por Mercado Pago, con el id de su sistema de pagos
preference_id
string
Identificador de la preferencia de pago asociado a la orden
Errores

400Error

invalid_user_id

invalid users involved.

invalid_order_state

the action requested is not valid for the current merchant order state.

invalid_string

string too long.

invalid_application_id

internal server error.

invalid_items

invalid unit_price.

user_not_allowed

user not allowed to operate.

invalid_operation_type

invalid operation type.

invalid_payer

invalid payer identifier.

invalid_id

invalid preference_id.

invalid_expired

the preference_id has expired.

invalid_sponsor_id

invalid sponsor_id.

invalid_marketplace

invalid marketplace.

unmarshal_error

could not unmarshal request body into merchant order struct.

invalid_url

invalid URL. Isn't HTTP or HTTPS.

communication_error

Error when calling...

401Error

invalid_token

access denied.

invalid_caller_id

invalid caller_id

Solicitud
curl -X POST \
    'https://api.mercadopago.com/merchant_orders'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    -d '{
  "external_reference": "default",
  "preference_id": "Preference identification",
  "sponsor_id": null,
  "payer": {
    "id": 123,
    "nickname": "JOHN"
  },
  "site_id": "MLA",
  "items": [
    {
      "id": "item id",
      "category_id": "item category",
      "currency_id": "BRL",
      "description": "item description",
      "picture_url": "item picture",
      "quantity": 1,
      "unit_price": 5,
      "title": "item title"
    }
  ],
  "application_id": "10000000000000000"
}'
Respuesta de ejemplo
{
  "id": 9999999999,
  "status": "closed",
  "external_reference": "default",
  "preference_id": "Preference identification",
  "collector": {
    "id": 999999999
  },
  "marketplace": "NONE",
  "date_created": "2018-09-14T17:11:31.000Z",
  "last_updated": "2018-09-14T17:11:43.000Z",
  "shipping_cost": 0,
  "total_amount": 5,
  "site_id": "MLA",
  "paid_amount": 5,
  "refunded_amount": 0,
  "payer": {
    "id": 999999999
  },
  "items": [
    {
      "id": "item id",
      "category_id": "item category",
      "currency_id": "BRL",
      "description": "item description",
      "picture_url": "item picture url",
      "title": "item title",
      "quantity": 1,
      "unit_price": 5
    }
  ],
  "additional_info": "additional information",
  "application_id": "10000000000000000",
  "order_status": "paid"
}