Este endpoint permite criar uma order para transações de pagamento (modo `automatic` - indica a order está pronta para ser processada) ou de reserva de pagamento (modo `manual` - indica que o pagamento está autorizado e retido até que uma captura seja realizada) com Mercado Pago Point. Em caso de sucesso, a requisição retornará uma resposta com o status 201.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
point.OBRIGATÓRIO
PDV e deve ser enviado apenas para criar uma order em modo reserva de pagamento. O único valor aceito é manual. Se omitido, a order será processada no modo automatic.PDV.400Erro.
empty_required_header
O header X-Idempotency-Key é requerido e não foi enviado. Faça a requisição novamente incluindo-o.
required_properties
Algumas propriedades obrigatórias estão ausentes. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente enviando as informações faltantes.
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.
invalid_expiration_time
O expiration_time enviado para uma order no modo reserva de pagamento é inválido. Quando processing_mode=manual, o valor deve estar entre 30 segundos (PT30S) e 3 minutos (PT3M). Ajuste-o 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.
401Erro.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
403Erro.
forbidden_checking_terminal_owner
O terminal Point não pertence ao usuário que enviou a solicitação. Verifique se o valor enviado para terminal_id está correto ou se o terminal está vinculado à sua conta.
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.
already_queued_order_for_terminal
O terminal já tem uma order em espera. É necessário finalizar ou cancelar para enviar novas orders.
500Erro.
idempotency_validation_failed
Falha na validação. Tente enviar a solicitação novamente.
500
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: 039b0d9c-fdf8-4d77-bdb8-1d4664bdff2f' \
-d '{
"type": "point",
"external_reference": "ext_ref_1234",
"expiration_time": "PT2M",
"processing_mode": "manual",
"transactions": {
"payments": [
{
"amount": "50.00"
}
]
},
"config": {
"point": {
"terminal_id": "NEWLAND_N950__SBX0000001",
"screen_time": "PT15S",
"print_on_terminal": "no_ticket"
},
"payment_method": {
"default_type": "credit_card"
}
},
"description": "Smartphone",
"integration_data": {
"platform_id": "dev_1234567890",
"integrator_id": "dev_123456",
"sponsor": {
"id": "446566691"
}
}
}'{
"id": "ORD00001111222233334444555566",
"type": "point",
"user_id": "5238400195",
"external_reference": "ext_ref_1234",
"description": "Smartphone",
"expiration_time": "PT2M",
"processing_mode": "automatic",
"country_code": "MEX",
"currency": "MXN",
"integration_data": {
"application_id": "1234567890",
"platform_id": "dev_1234567890",
"integrator_id": "dev_123456",
"sponsor": {
"id": "446566691"
}
},
"status": "created",
"status_detail": "created",
"created_date": "2024-09-10T14:26:42.109320977Z",
"last_updated_date": "2024-09-10T14:26:42.109320977Z",
"config": {
"point": {
"terminal_id": "NEWLAND_N950__SBX0000001",
"screen_time": "PT15S",
"print_on_terminal": "no_ticket"
},
"payment_method": {
"default_type": "credit_card"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "50.00",
"status": "created"
}
]
}
}