POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Erro.
empty_required_header
O header 'X-Idempotency-Key' é requerido e não foi enviado. Faça a requisição novamente incluindo-o.
unsupported_site
Foi feita uma tentativa de criar a order de um país não suportado. Certifique-se de ter a autorização necessária.
unsupported_properties
Foi enviada uma propriedade que não é suportada. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.
bad_request
Foi feita uma tentativa de criar a order com campos não suportados ou inválidos. Tente enviar a solicitação novamente, validando todos os campos.
property_value
Um valor inválido foi enviado para alguma propriedade. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.
property_type
Um tipo inválido foi enviado para alguma propriedade. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.
marketplace_not_valid
O Access Token enviado como header na solicitação não foi obtido pelo protocolo OAuth e, portanto, não é possível identificar um marketplace válido. Verifique se você concluiu o processo corretamente.
sponsor_id_not_valid
Um valor inválido foi enviado como identificador de conta do Mercado Pago (USER_ID). Verifique a mensagem retornada nos detalhes do erro para descobrir qual foi o problema e tente novamente.
401Erro.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
404Erro.
marketplace_fee_not_allowed
O campo "marketplace_fee" não pode ser enviado porque o marketplace não foi encontrado. Verifique se enviou o Access Token correto e tente novamente.
pos_not_found
O valor inserido para o campo "external_pos_id" não pertence a nenhuma caixa. Confirme se você inseriu o valor correto e tente novamente.
409Erro.
idempotency_key_already_used
O valor enviado como header de idempotência já foi utilizado em uma solicitação diferente em um período menor que 24 horas. Por favor, tente a solicitação novamente enviando um novo valor.
500Erro.
500
Erro genérico. Verifique a mensagem retornada e tente enviar a solicitação novamente.
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"
}
}