Este endpoint permite atualizar as informações de uma transação de pagamento da order.
PUT
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
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. ID inválido.
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 64 caracteres.
invalid_path_param
O "order_id" fornecido no path da requisição está incorreto. Forneça um ID válido e realize uma nova requisição.
invalid_transaction_id
O "transaction_id" fornecido no path da requisição está incorreto. Forneça um ID válido e realize uma nova requisição.
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.
404Error. Order 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 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.
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.
internal_error
Erro genérico. Tente realizar uma nova requisição.
curl -X PUT \
'https://api.mercadopago.com/v1/orders/{order_id}/transactions/{transaction_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Idempotency-Key: 784c0bc3-ecce-41d1-a84c-c3016e644a8b' \
-d '{
"payment_method": {
"id": "master",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "My Store"
}
}'{
"payment_method": {
"id": "master",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "My Store"
}
}