Disponível apenas para terminais configurados no modo PDV, este endpoint permite capturar — total ou parcialmente — uma order do Mercado Pago Point previamente autorizada em modo reserva de pagamento, que é ativado ao se criar uma order POST /v1/orders em modo manual (processing_mode=manual). A funcionalidade de autorização e captura em duas etapas deve ser habilitada previamente em sua conta pela equipe comercial do Mercado Pago. Entre em contato com seu assessor comercial para solicitar a ativação. Para uma captura total da order, envie o body vazio e, para uma captura parcial, envie o array transactions.payments com o ID do pagamento e o valor a capturar. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO CONDICIONAL
400Erro.
empty_required_header
O header X-Idempotency-Key é requerido e não foi enviado. Faça a requisição novamente incluindo-o.
bad_request
O order_id fornecido no path da requisição não está correto. Verifique e forneça um ID válido para tentar novamente.
unsupported_properties
O body da solicitação contém propriedades não suportadas. Para captura total, envie o body vazio. Para captura parcial, somente as propriedades transactions.payments.id e transactions.payments.amount são aceitas.
401Credenciais inválidas.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente enviar a requisição novamente com o valor correto.
404Order não encontrada.
order_not_found
Order não encontrada. Verifique se o ID enviado está correto.
409Alguma regra específica do sistema não permite que a ação seja realizada.
cannot_capture_order
A order não pode ser capturada. Somente orders com status=action_required e status_detail=waiting_capture podem ser capturadas. Verifique o status atual da order antes de tentar novamente.
idempotency_key_already_used
O valor enviado como header de idempotência (X-Idempotency-Key) já foi utilizado em uma solicitação diferente em um período de 24 horas. Por favor, tente a solicitação novamente com um novo valor.
operation_not_supported
Esta operação não é suportada para a order em seu estado atual. Verifique o status e o status_detail da order.
422Entidade não processável.
invalid_capture_amount
O valor de captura é inválido. Deve ser maior que 0 e menor ou igual ao valor autorizado na criação da order. Verifique o valor a capturar e tente novamente.
capture_exceeds_authorized
O valor de captura supera o valor autorizado. O valor a capturar não pode ser maior que o valor autorizado na criação da order. Ajuste o valor e tente novamente.
500Erro genérico.
idempotency_validation_failed
Falha na validação de idempotência. 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/{order_id}/capture'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Idempotency-Key: 66ce39f6-10aa-465e-b71d-218a55b043ee' \
-d '{
"transactions": {
"payments": [
{
"id": "PAY01ABCDEFGHIJKLMNOPQRSTUVWX",
"amount": "35.00"
}
]
}
}'{
"id": "ORD01ABCDEFGHIJKLMNOPQRSTUVWX",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"payments": [
{
"id": "PAY01ABCDEFGHIJKLMNOPQRSTUVWX",
"amount": "1500.00",
"paid_amount": "35.00",
"status": "processed",
"status_detail": "accredited"
}
]
}
}