POST
REQUERIDO
REQUERIDO
REQUERIDO
400Error.
empty_required_header
El header 'X-Idempotency-Key' es requerido y no fue enviado. Vuelve a realizar la petición incluyéndolo.
unsupported_site
Se ha intentado crear la order desde un país que no es soportado. Asegúrate de contar con la autorización necesaria.
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.
bad_request
Se intentó crear la order con campos no soportados o inválidos. Vuelve a intentar enviar la solicitud, validando todos los campos.
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.
property_type
Se envió un tipo 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.
marketplace_not_valid
El Access Token enviado como header en la requisición no es uno obtenido mediante el protocolo OAuth y, por lo tanto, no es posible identificar un marketplace válido. Verifica haber realizado el proceso correctamente.
sponsor_id_not_valid
Se envió un valor inválido como identificador de la cuenta de Mercado Pago (USER_ID). 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.
404Error.
marketplace_fee_not_allowed
No está permitido enviar el campo "marketplace_fee" debido a que el marketplace no fue encontrado. Por favor, valida que estés utilizando el Access Token correcto e intenta nuevamente.
pos_not_found
El valor ingresado para el campo "external_pos_id" no pertenece a ninguna caja. Valida haber ingresasado el correcto y vuelve a intentarlo.
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.
500Error.
500
Error genérico. Verifica el mensaje retornado e 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 TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
-d '{
"type": "qr",
"total_amount": "50.00",
"description": "Point New Land",
"external_reference": "ext_ref_1234",
"expiration_time": "PT16M",
"marketplace_fee": "11.22",
"integration_data": {
"platform_id": "dev_1234567890",
"integrator_id": "dev_1234",
"sponsor": {
"id": "446566691"
}
},
"config": {
"qr": {
"external_pos_id": "EXTERNALPOS019285",
"mode": "static"
}
},
"transactions": {
"payments": [
{
"amount": "50.00"
}
]
},
"taxes": [
{
"payer_condition": "payment_taxable_iva"
}
],
"items": [
{
"title": "Point New Land",
"unit_price": "50.00",
"quantity": 1,
"unit_measure": "kg",
"external_code": "777489134",
"external_categories": [
{
"id": "device"
}
]
}
],
"discounts": {
"payment_methods": [
{
"new_total_amount": "47.28",
"type": "account_money"
}
]
}
}'{
"id": "ORD00001111222233334444555566",
"user_id": "5238400195",
"type": "qr",
"external_reference": "ext_ref_1234",
"description": "Point Mini",
"expiration_time": "PT16M",
"processing_mode": "automatic",
"total_amount": "50.00",
"country_code": "CHL",
"marketplace_fee": "11.22",
"integration_data": {
"application_id": "1234567890",
"platform_id": "dev_1234567890",
"integrator_id": "dev_1234",
"sponsor": {
"id": "446566691"
}
},
"status": "created",
"status_detail": "created",
"created_date": "2024-09-10T14:26:42.109Z",
"last_updated_date": "2024-09-10T14:27:42.109Z",
"config": {
"qr": {
"external_pos_id": "EXTERNALPOS019285",
"mode": "static"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "50.00",
"status": "created",
"status_detail": "ready_to_process"
}
]
},
"taxes": [
{
"payer_condition": "payment_taxable_iva"
}
],
"items": [
{
"title": "Point New Land",
"unit_price": "50.00",
"quantity": 1,
"unit_measure": "kg",
"external_code": "777489134",
"external_categories": [
{
"id": "food"
}
]
}
],
"discounts": {
"payment_methods": [
{
"new_total_amount": "47.28",
"type": "account_money"
}
]
},
"type_response": {
"qr_data": "00020101021243650016com.mercadolibre020130636261ba79b-e543-41c7-b71a-cec05c18e72b50120008326594305204970053030325802AR5904Test6004CABA63041094"
}
}