Este endpoint permite criar uma order no modo "automático" (processando a transação em uma única etapa) ou "manual" (processando a transação em etapas que podem ser configuradas e executadas de forma incremental) para transações de pagamento. Em caso de sucesso, a requisição retornará uma resposta com o status 201.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Erro de requisição.
empty_required_header
O header "X-Idempotency-Key" é requerido e não foi enviado. Faça a requisição novamente incluindo-o.
invalid_idempotency_key_length
O valor enviado no header "X-Idempotency-Key" excedeu o tamanho máximo permitido. O header aceita valores entre 1 e 64 caracteres.
required_properties
Algumas propriedades obrigatórias estão ausentes. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
unsupported_properties
Foi enviada uma propriedade que não é suportada. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
minimum_properties
O número mínimo de propriedades necessárias para executar a solicitação não foi enviado. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
property_type
Um tipo de propriedade incorreto foi enviado. Por exemplo, um valor 'integer' para uma propriedade 'string'. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
minimum_items
O número mínimo de itens para alguma propriedade não foi enviado. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
maximum_items
Foi enviado um número de itens maior do que o permitido para alguma propriedade. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
property_value
Um valor inválido foi enviado para alguma propriedade. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
json_syntax_error
Um JSON inválido foi enviado. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
invalid_properties
Informações incorretas foram enviadas. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
invalid_total_amount
O valor informado em "total_amount" não equivale à soma do campo "transactions.payments.amount" do total de transações. Verifique se os valores estão corretos.
invalid_email_for_sandbox
O formato do email é inválido para o ambiente de sandbox, deve conter "@testuser.com".
order_invalid_sponsor_id
O identificador do patrocinador da order é inválido. Certifique-se de que o ID está correto.
order_builder_without_transactions
O nó "transactions" da order criada em modo 'manual' não pode ser um array vazio. Envie-o com o valor 'null' para tentar novamente.
invalid_order_type
O tipo de order fornecido é inválido ou não é suportado. Esperado um de: "online".
invalid_header_value
Identificador do chamador ("caller_id") não encontrado. Certifique-se de que o ID está correto.
401Erro. Access Token não autorizado.
401
O Access Token enviado está incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.
invalid_credentials
Não há suporte para credenciais de teste. Utilize usuários de teste com credenciais de produção para o ambiente de teste (sandbox) e as suas credenciais de produção para o ambiente de produção.
402Erro de processamento.
402
A order foi criada mas alguma transação falhou. Verifique o campo "erros" para mais informações.
409Alguma regra específica do sistema não permite a realização da ação devido a restrições definidas.
idempotency_key_already_used
O valor enviado como header de idempotência já foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.
423Recurso bloqueado.
resource_locked
Chave de idempotência bloqueada. Por favor, tente novamente após algum tempo.
500Erro genérico.
idempotency_validation_failed
Falha na validação. Tente enviar a solicitação novamente.
internal_error
Erro genérico. Tente enviar a solicitação novamente.
curl -X POST \
'https://api.mercadopago.com/v1/orders'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Idempotency-Key: 6278f64e-3865-403c-b683-f9d229251931' \
-d '{
"type": "online",
"external_reference": "ext_ref_1234",
"transactions": {
"payments": [
{
"amount": "50.00",
"payment_method": {
"id": "oxxo",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "My Store"
},
"expiration_time": "P3Y6M4DT12H30M5S",
"date_of_expiration": "2023-03-01T10:00:00.000-04:00"
}
]
},
"payer": {
"email": "test_user_mx@testuser.com",
"entity_type": "individual",
"first_name": "Miguel",
"last_name": "Hernández",
"identification": {
"type": "CURP",
"number": "MEMP840321HDFRNSO"
},
"phone": {
"area_code": "55",
"number": "987-654-321"
},
"address": {
"zip_code": "03940",
"street_name": "Rua Teste",
"street_number": "1602",
"state": "CDMX",
"city": "México",
"complement": "Apto 303"
}
},
"shipment": {
"address": {
"zip_code": "03940",
"street_name": "Rua Teste",
"street_number": "1602",
"neighborhood": "Crédito Constructor",
"city": "México",
"state": "CDMX",
"complement": "Apto 303"
}
},
"total_amount": "50.00",
"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": "24.50",
"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": "50.00",
"total_paid_amount": "50.00",
"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": "MX",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "automatic_async",
"shipment": {
"address": {
"zip_code": "03940",
"street_name": "Rua Teste",
"street_number": "1602",
"neighborhood": "Crédito Constructor",
"city": "México",
"state": "CDMX",
"complement": "Apto 303"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"paid_amount": "50.00",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
"status": "processed",
"status_detail": "accredited",
"expiration_time": "P3Y6M4DT12H30M5S",
"payment_method": {
"id": "oxxo",
"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",
"transaction_security": {
"validation": "on_fraud_risk",
"liability_shift": "required",
"url": "https://www.mercadopago.com/auth/card/validation/pages/remedies/019ada0a-fe1f-7a82-ba1a-1ccb4e0232e7?display_mode=self_hosted&guest_token=0661345a-e0e1-4c09-aff9-b7929ca9a24a",
"id": "019ada0a-fe1f-7a82-ba1a-1ccb4e0232e7",
"type": "three_ds",
"status": "NOT_AUTHENTICATED"
}
},
"date_of_expiration": "2023-03-01T10:00:00.000-04:00"
}
]
},
"description": "Smartphone",
"items": [
{
"title": "Smartphone",
"unit_price": "24.50",
"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"
}