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 e cashout. 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
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.
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.
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-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-H 'X-Idempotency-Key: 9118d9a2-1820-4467-b7a9-57e1aa63e3c6' \
-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"
}