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 online - Mercado Pago Developers

BĂșsqueda inteligente powered by OpenAI 

Crear order

POST

https://api.mercadopago.com/v1/orders
Este endpoint permite crear una order en modo "automĂĄtico" (procesando la transacciĂłn en una sola etapa) o "manual" (procesando la transacciĂłn en etapas que pueden ser configuradas y ejecutadas de manera incremental) para transacciones de pago y cashout. 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, asociada a la soluciĂłn de Mercado Pago para la que se crea. Para pagos online con tarjetas, el Ășnico valor posible es "online".
online: Valor asociado a la creaciĂłn de Ăłrdenes para pagos online.
external_reference
string

REQUERIDO

Es una referencia externa de la order. Puede ser, por ejemplo, un hashcode del Banco Central, funcionando como identificador de origen de la transacciĂłn. Este campo debe tener como mĂĄximo 64 caracteres y estos solo puede...Ver mĂĄs
transactions
object

REQUERIDO

Contiene informaciĂłn sobre las transacciones asociadas a la order. Puede contener hasta 2 transacciones. Por ejemplo, en caso de querer crear una order con dos tarjetas, puedes agregar un Ă­tem al array "payments", dividi...Ver mĂĄs
payer
object
InformaciĂłn del pagador
ParĂĄmetros de respuesta
id
string
Identificador de la order creada en la solicitud, generado automĂĄticamente por Mercado Pago.
processing_mode
string
Modo de procesamiento de la order
manual: El procesamiento de la order se harĂĄ de manera manual. Es el modo de procesamiento utilizado para la opciĂłn "manual", en tanto configura que el procesamiento sea hecho posteriormente, utilizando el endpoint "Procesar order por ID".
automatic: El procesamiento de la order se harĂĄ instantĂĄneamente. Es el modo de procesamiento utilizado para la opciĂłn "automĂĄtico".
external_reference
string

REQUERIDO

Es una referencia externa de la order. Puede ser, por ejemplo, un hashcode del Banco Central, funcionando como identificador de origen de la transacciĂłn. Este campo debe tener como mĂĄximo 64 caracteres y estos solo puede...Ver mĂĄs
total_amount
string
Monto total a pagar. Debe ser enviado con dos nĂșmeros decimales.
Errores

400Error.

empty_required_header

El header 'X-Idempotency-Key' es requerido y no fue enviado. Vuelve a realizar la requisició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.

invalid_properties

Se enviĂł informaciĂłn incorrecta. Chequea el mensaje devuelto en los detalles del error para saber cuĂĄl fue el problema y vuelve a intentarlo.

invalid_total_amount

El valor ingresado en "total_amount" no es equivalente a la suma del campo "transactions.payments.amount" del total de las transacciones. Por favor, verifica que los valores sean correctos.

invalid_email_for_sandbox

El formato del email es invĂĄlido para el ambiente de sandbox, debe contener "@testuser.com".

401Error. Access Token no autorizado.

401

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

409Alguna regla especĂ­fica del sistema no permite realizar la acciĂłn debido a restricciones definidas.

idempotency_key_already_used

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

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": "online",
  "external_reference": "ext_ref_1234",
  "transactions": {
    "payments": [
      {
        "amount": "24.90",
        "payment_method": {
          "id": "visa",
          "type": "credit_card",
          "token": "12345",
          "installments": 1,
          "statement_descriptor": "approved"
        }
      }
    ]
  },
  "payer": {
    "email": "test@test.com",
    "first_name": "John",
    "last_name": "Doe",
    "identification": {
      "type": "CPF",
      "number": "99999999999"
    },
    "phone": {
      "area_code": "11",
      "number": "987654321"
    },
    "address": {
      "zip_code": "12345678",
      "street_name": "Rua Teste",
      "street_number": "123"
    }
  },
  "total_amount": "24.90",
  "capture_mode": "manual",
  "processing_mode": "automatic",
  "description": "Point Mini",
  "marketplace": "MERCADOLIVRE",
  "integration_data": {
    "integrator_id": "dev_123",
    "platform_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "items": [
    {
      "title": "Point Mini",
      "unit_price": "12.90",
      "quantity": 4,
      "description": "Point product for card payments via Bluetooth.",
      "id": "1234",
      "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
      "category_id": "MLB1055"
    }
  ],
  "expiration_time": "P3Y6M4DT12H30M5S"
}'
Respuesta de ejemplo
{
  "id": "123",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "total_amount": "24.90",
  "integration_data": {
    "application_id": "1234",
    "integrator_id": "dev_123",
    "platform_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "created_date": "2024-08-26T13:06:51.045317772Z",
  "last_updated_date": "2024-08-26T13:06:51.045317772Z",
  "country_code": "BRA",
  "type": "online",
  "status": "processed",
  "status_detail": "accredited",
  "capture_mode": "manual",
  "payer": {
    "email": "test@test.com",
    "first_name": "John",
    "last_name": "Doe",
    "identification": {
      "type": "CPF",
      "number": "99999999999"
    },
    "phone": {
      "area_code": "11",
      "number": "987654321"
    },
    "address": {
      "zip_code": "12345678",
      "street_name": "Rua Teste",
      "street_number": "123"
    }
  },
  "transactions": {
    "payments": [
      {
        "id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24.90",
        "status": "processed",
        "status_detail": "accredited",
        "payment_method": {
          "id": "visa",
          "type": "credit_card",
          "token": "12345",
          "installments": 1,
          "statement_descriptor": "approved"
        }
      }
    ]
  },
  "description": "Point Mini",
  "marketplace": "MERCADOLIVRE",
  "items": [
    {
      "title": "Point Mini",
      "unit_price": "12.90",
      "quantity": 4,
      "description": "Point product for card payments via Bluetooth.",
      "id": "1234",
      "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
      "category_id": "MLB1055"
    }
  ],
  "expiration_time": "P3Y6M4DT12H30M5S"
}