Este endpoint captura uma order de Wallet Connect previamente autorizada, onde apenas a sua captura total é suportada. Aplica-se apenas a orders criadas com capture_mode=manual e que estão em status=action_required e status_detail=waiting_capture. Após a captura, a order passará para status=processed e status_detail=accredited. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
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.
invalid_path_param
O order_id fornecido no path não é válido. Verifique e forneça um order_id válido para tentar novamente.
401Erro. Access Token não autorizado.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente enviar a requisição novamente com o valor correto.
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.
404Recurso não encontrado.
order_not_found
Order não encontrada. Verifique se o order_id enviado está correto.
payment_not_found
Pagamento não encontrado. Verifique se o payment_id enviado está correto.
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.
cannot_capture_order
A order não pode ser capturada porque não está em um status que permite a captura. Apenas orders no status action_required com capture_mode=manual podem ser capturadas.
operation_not_supported
A operação não é suportada para esta order. Verifique o status e status_detail da order e tente novamente.
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/{order_id}/capture'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Idempotency-Key: 934d3107-7a09-4bfc-ac20-c0ce67643416' \
{
"id": "ORDBTA01KHY4WFPYXJ9Z7S5CGED7WCTP",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"payments": [
{
"id": "PAY01KSND6GMT3KAG0Z2TB9M8B0WW",
"amount": "50.50",
"paid_amount": "50.50",
"status": "processed",
"status_detail": "accredited",
"reference_id": "ref-capture"
}
]
}
}