Este endpoint permite criar uma order para transações de pagamento com Wallet Connect. Em caso de sucesso, a requisição retornará uma resposta com o status 201.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
online.OBRIGATÓRIO
OBRIGATÓRIO
automatic.400Erro de requisição.
empty_required_header
O header X-Idempotency-Key é obrigatório e não foi enviado. Faça a requisição novamente incluindo-o.
invalid_idempotency_key_length
O X-Idempotency-Key deve ter 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
Uma propriedade não suportada foi enviada. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
minimum_properties
O número mínimo de propriedades requeridas não foi enviado.
property_type
Tipo de propriedade incorreto foi enviado. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
minimum_items
O tamanho do array está abaixo do mínimo permitido.
maximum_items
O tamanho do array excede o máximo permitido.
property_value
Um valor incorreto para alguma propriedade foi enviado. 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 fornecidas.
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_order_type
O type da order é inválido ou não suportado.
401Erro. Token de pagamento não autorizado.
unauthorized_payer_token
O payer_token fornecido não está autorizado para esta transação. Verifique se o token é válido e pertence ao pagador autenticado.
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 errors 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 (X-Idempotency-Key) já foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.
operation_not_supported
A operação não é suportada para esta order. Verifique o status e status_detail da order e tente novamente.
422Erro.
unprocessable_entity
O perfil de pagamento associado ao payer_token está corrompido ou incompleto.
423Recurso bloqueado.
resource_locked
A chave de idempotência (X-Idempotency-Key) está bloqueada por uma requisição em andamento. Por favor, tente novamente após um breve intervalo.
500Erro genérico.
idempotency_validation_failed
Falha na validação de idempotência. 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-1*********550113-12*********b4773884a*********e8df16347*********786' \
-H 'X-Idempotency-Key: 981ac71c-031b-44b4-beb0-eb3d738ec575' \
-d '{
"type": "online",
"external_reference": "ext_ref_1234",
"total_amount": "50.00",
"description": "Smartphone",
"capture_mode": "automatic",
"integration_data": {
"platform_id": "123abc"
},
"transactions": {
"payments": [
{
"amount": "50.00",
"payment_method": {
"type": "wallet",
"id": "wallet",
"token": "123abc123abc123abc123abc123abc12",
"statement_descriptor": "My Store"
},
"stored_credential": {
"reason": "recurring",
"payment_initiator": "merchant"
}
}
]
}
}'{
"id": "ORDBTA01KHY4WFPYXJ9Z7S5CGED7WCTP",
"type": "online",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"description": "Smartphone",
"total_amount": "50.00",
"total_paid_amount": "50.00",
"country_code": "PE",
"user_id": "1090806071",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "automatic",
"currency": "PEN",
"created_date": "2026-02-20T18:27:08.639Z",
"last_updated_date": "2026-02-20T18:27:09.797Z",
"integration_data": {
"application_id": "8251964915044164",
"platform_id": "123abc"
},
"transactions": {
"payments": [
{
"id": "PAY01KHY4WFPYXJ9Z7S5CGG0SE8KN",
"amount": "50.00",
"paid_amount": "47.28",
"reference_id": "30f45a189ec043c28e6c4b73e0dd65a3",
"status": "processed",
"status_detail": "accredited",
"attempts": [
{
"id": "514336a54ba74712a2478d0e79c92b14",
"status": "processed",
"status_detail": "accredited",
"payment_method": {
"id": "wallet",
"type": "wallet",
"installments": 1
}
}
],
"payment_method": {
"id": "wallet",
"type": "wallet",
"statement_descriptor": "Descriptor",
"installments": 1
},
"stored_credential": {
"payment_initiator": "merchant",
"reason": "recurring"
}
}
]
}
}