Este endpoint permite capturar totalmente uma order previamente autorizada. Cada pagamento associado será capturado totalmente. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
status=processing, o pagamento está sendo processado.Erros
Cada resposta da API inclui um código de status HTTP com o resultado da requisição. O código 200 indica sucesso, o 400 um erro nos dados enviados e o 500 uma falha interna no servidor.
Alguns erros 400 podem ser tratados de forma programática e incluem um código que descreve a causa do erro.
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.
invalid_path_param
O order_id fornecido no path da requisição não está correto. Verifique e forneça um ID válido para tentar novamente.
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.
402Erro de processamento.
402
A order foi criada mas alguma transação falhou. Verifique o campo errors para mais informações.
403Erro. Proibido.
forbidden
A aplicação não tem permissão para acessar este recurso. Verifique se o Access Token utilizado tem as permissões e escopos necessários para esta operação.
PA_UNAUTHORIZED_RESULT_FROM_POLICIES
A conta está bloqueada e suas chaves de API foram revogadas. Ao menos uma política avaliada pelo Policy Agent retornou um resultado não autorizado (UNAUTHORIZED).
404Error. Order não encontrada.
order_not_found
Order não encontrada. Verifique se o order_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
Erro. Order não pode ser capturada. O status da order não permite a sua captura. Apenas orders com status=action_required e status_detail=waiting_capture 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.
429Limite de requisições excedido.
too_many_requests
Client ID bloqueado pelo gateway porque o limite de requisições pelo ID em questão foi atingido. Leia o header Retry-After da resposta e aguarde o número de segundos indicado antes de tentar novamente. Para maior resiliência, implemente backoff exponencial com jitter, ou seja, aumente o tempo de espera a cada nova tentativa e adicione uma variação aleatória para evitar o reenvio simultâneo de muitas requisições.
usage_quota_exceeded
Cota imposta pelo backend da API porque o limite de requisições por cliente foi atingido. Leia o header Retry-After da resposta e aguarde o número de segundos indicado antes de tentar novamente. Para maior resiliência, implemente backoff exponencial com jitter, ou seja, aumente o tempo de espera a cada nova tentativa e adicione uma variação aleatória para evitar o reenvio simultâneo de muitas requisições.
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: c7f142d7-dcfd-4ca7-985a-a6f327f6f8d6' \
{
"id": "ORD01J49MMW3SSBK5PSV3DFR32959",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"payments": [
{
"id": "PAY01J49MMW3SSBK5PSV3DFR32959",
"amount": "24.50",
"status": "processed",
"status_detail": "accredited",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9"
}
]
}
}