Este endpoint permite criar uma order no modo "manual" para fluxos de pagamento com Checkout Pro. Em caso de sucesso, a requisição retornará uma resposta com o status 201 e um checkout_url para redirecionar o comprador.
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 128 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.
order_items_total_amount_mismatch
O valor informado em "total_amount" não equivale à soma de `items[].unit_price` multiplicado por `items[].quantity` de todos os itens. Verifique se os valores estão corretos.
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.
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.
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.
json_syntax_error
Um JSON inválido foi enviado. 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.
idempotency_validation_failed
Falha na validação. Tente enviar a solicitação novamente.
invalid_email_for_sandbox
O formato do email é inválido para o ambiente de sandbox, deve conter "@testuser.com".
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.
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 ("X-Idempotency-Key") já foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.
422Entidade não processável. A requisição está bem formada, mas não pode ser processada.
unprocessable_entity
A requisição não pôde ser processada. Identificação do usuário ausente ou o payload não atende às condições necessárias.
423Recurso bloqueado.
resource_locked
Chave de idempotência bloqueada. Por favor, tente novamente após algum tempo.
500Erro genérico.
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 ' \
-H 'X-Idempotency-Key: 7f2c00ff-71b4-4300-92cb-3792c1f519d6' \
-d '{
"type": "online",
"total_amount": "50.00",
"external_reference": "ext_ref_1234",
"processing_mode": "manual",
"capture_mode": "automatic_async",
"marketplace_fee": "11.20",
"expiration_time": "P1D",
"payer": {
"email": "test@testuser.com",
"first_name": "Valentina",
"last_name": "Martínez",
"phone": {
"area_code": "11",
"number": "999998888"
},
"identification": {
"type": "CPF",
"number": "12345678909"
},
"address": {
"zip_code": "11300",
"street_number": "1294",
"neighborhood": "Pocitos",
"city": "Montevideo"
}
},
"config": {
"statement_descriptor": "MYSTORE",
"default_payment_due_date": "P1D",
"online": {
"available_from": "2026-01-01T00:00:00Z",
"allowed_user_type": "account_only",
"success_url": "https://www.example.com/success",
"failure_url": "https://www.example.com/failure",
"pending_url": "https://www.example.com/pending",
"auto_return": "approved",
"tracks": [
{
"type": "google_ad",
"values": {
"conversion_id": "21312312312123",
"conversion_label": "TEST",
"pixel_id": "21312312312123"
}
}
]
},
"payment_method": {
"max_installments": 12,
"not_allowed_ids": [
"amex"
],
"not_allowed_types": [
"credit_card"
],
"installments": {
"interest_free": {
"type": "range",
"values": [
2,
6
]
}
}
}
},
"items": [
{
"external_code": "ITEM-001",
"title": "Product 001",
"description": "Product description",
"category_id": "travels",
"picture_url": "https://example.com/img.jpg",
"quantity": 1,
"unit_price": "1000.00",
"type": "travel",
"warranty": false,
"event_date": "2014-06-28T16:53:03.176-04:00"
}
],
"additional_info": {
"payer.registration_date": "2020-01-15T00:00:00.000-03:00",
"payer.authentication_type": "MOBILE",
"payer.is_prime_user": false,
"payer.is_first_purchase_online": false,
"payer.last_purchase": "2025-12-01T00:00:00.000-03:00",
"travel.passengers": [
{
"first_name": "John",
"last_name": "Smith",
"identification_type": "DNI",
"identification_number": "12345678909",
"item_references": [
"ITEM-001"
]
}
],
"travel.routes": [
{
"departure": "SAO",
"destination": "RIO",
"departure_date_time": "2026-03-10T08:00:00.000-03:00",
"arrival_date_time": "2026-03-10T09:00:00.000-03:00",
"company": "TAM",
"item_references": [
"ITEM-001"
]
}
]
},
"description": "Smartphone"
}'{
"id": "ORDTST01KS5AJ6HTK2HRQ3XJ3C2JCKP9",
"type": "online",
"processing_mode": "manual",
"status": "created",
"status_detail": "accredited",
"external_reference": "ext_ref_1234",
"total_amount": "50.00",
"total_paid_amount": "50.00",
"marketplace_fee": "11.20",
"checkout_url": "https://www.mercadopago.com.ar/checkout/v1/redirect?order_id=ORDTST01KS5AJ6HTK2HRQ3XJ3C2JCKP9",
"expiration_time": "P1D",
"country_code": "UY",
"user_id": "12345",
"currency": "UYU",
"capture_mode": "automatic_async",
"client_token": "eyJhbGciOiJSUzI1NiIs...",
"created_date": "2024-08-26T13:06:51.045317772Z",
"last_updated_date": "2024-08-26T13:06:51.045317772Z",
"integration_data": {
"application_id": "8772548647196351",
"integrator_id": "dev_123",
"platform_id": "1234567890",
"sponsor": {
"id": "446566691"
}
},
"config": {
"online": {
"callback_url": "https://www.example.com/",
"success_url": "https://www.example.com/success",
"failure_url": "https://www.example.com/failure",
"pending_url": "https://www.example.com/pending",
"available_from": "2026-05-16T18:32:00Z",
"auto_return": "approved",
"retries": {
"allowed": false
}
},
"payment_method": {
"max_installments": 12,
"not_allowed_ids": [
"amex"
],
"not_allowed_types": [
"ticket"
],
"default_type": "credit_card",
"installments_cost": "seller",
"installments": {
"interest_free": {
"type": "range",
"values": [
2,
6
]
},
"available": {
"type": "all"
}
}
}
},
"items": [
{
"external_code": "ITEM-001",
"title": "Product 001",
"description": "Product description",
"category_id": "travels",
"picture_url": "https://example.com/img.jpg",
"quantity": 1,
"unit_price": "1000.00",
"type": "travel",
"warranty": true,
"event_date": "2014-06-28T16:53:03.176-04:00"
}
],
"description": "Travel package SAO-RIO with insurance"
}