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.
POST
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
400Error de solicitud.
empty_required_header
El header "X-Idempotency-Key" es requerido y no fue enviado. Vuelve a realizar la requisición incluyéndolo.
invalid_idempotency_key_length
El valor enviado en el header "X-Idempotency-Key" excedió el tamaño máximo permitido. El header acepta valores entre 1 y 64 caracteres.
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".
order_invalid_sponsor_id
El identificador del patrocinador de la order es inválido. Asegúrate de que el ID esté correcto.
invalid_header_value
El identificador del chamador ("caller_id") no fue encontrado. Asegúrate de que el ID esté correcto.
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.
invalid_credentials
No hay soporte para credenciales de prueba. Use usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y sus credenciales de producción para el entorno de producción.
402Error de procesamiento.
402
La order fue creada pero alguna transacción ha fallado. Consulte el campo "errores" para obtener más información.
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 genérico.
idempotency_validation_failed
Falla en la validación de idempotencia. Intenta enviar la solicitud nuevamente.
internal_error
Error genérico. Intenta enviar la solicitud nuevamente.
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-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-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": "My Store"
},
"expiration_time": "P3Y6M4DT12H30M5S"
}
]
},
"payer": {
"email": "test@testuser.com",
"entity_type": "individual",
"first_name": "Carolina",
"last_name": "Pérez",
"identification": {
"type": "RUT",
"number": "99999999999"
},
"phone": {
"area_code": "2",
"number": "2234-5678"
},
"address": {
"zip_code": "7550000",
"street_name": "Rua Teste",
"street_number": "4800",
"state": "Región Metropolitana",
"city": "Osasco",
"complement": "Apto 303"
}
},
"total_amount": "24.90",
"capture_mode": "automatic_async",
"processing_mode": "automatic",
"description": "Smartphone",
"integration_data": {
"integrator_id": "dev_123",
"platform_id": "1234567890",
"sponsor": {
"id": "446566691"
}
},
"items": [
{
"title": "Smartphone",
"unit_price": "12.90",
"quantity": 4,
"description": "Smartphone",
"external_code": "1234",
"picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
"category_id": "MLB1055",
"type": "MLB1055",
"warranty": true,
"event_date": "2014-06-28T16:53:03.176-04:00"
}
]
}'{
"id": "ORD01J49MMW3SSBK5PSV3DFR32959",
"type": "online",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"total_amount": "24.90",
"total_paid_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": "CL",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "automatic_async",
"shipment": {
"address": {
"zip_code": "7550000",
"street_name": "Rua Teste",
"street_number": "4800",
"neighborhood": "Pres. Altino",
"city": "Osasco",
"state": "Región Metropolitana",
"complement": "Apto 303"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.90",
"paid_amount": "24.90",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
"status": "processed",
"status_detail": "accredited",
"expiration_time": "P3Y6M4DT12H30M5S",
"payment_method": {
"id": "visa",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "My Store",
"ticket_url": "https://www.mercadopago.com.ar/payments/86797024510/ticket?caller_id=1870026883&payment_method_id=rapipago&payment_id=86797024510&payment_method_reference_id=6004835002&hash=0331521a-9ddb-44a2-851c-65f77d8d394e",
"barcode_content": "3335008800000000006004835002100020000242462010",
"reference": "6005407530",
"verification_code": "6005407530",
"financial_institution": "bradesco",
"digitable_line": "23793380296060054351030006333303799140000020000",
"qr_code": "00020126580014br.gov.bcb.pix0136b76aa9c2-2ec4-4110-954e-ebfe34f05b61520400005303986540510.005802BR5912TESTPVBWOSBE6009Sao Paulo62240520mpqrinter715936942186304C3C0",
"qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAABWQAAAVkAQAAAAB79i",
"e2e_id": "PIXE18236120202509281610s04cf5a1234"
},
"date_of_expiration": "2023-03-01T10:00:00.000-04:00"
}
]
},
"description": "Smartphone",
"items": [
{
"title": "Smartphone",
"unit_price": "12.90",
"quantity": 4,
"description": "Smartphone",
"external_code": "1234",
"picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
"category_id": "MLB1055",
"type": "MLB1055",
"warranty": "true",
"event_date": "2014-06-28T16:53:03.176-04:00"
}
],
"client_token": "QWERTY12345.ASDFG67890"
}