Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Atualizar uma transação da order - Pagamentos online - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Atualizar uma transação da order

PUT

https://api.mercadopago.com/v1/orders/{order_id}/transactions/{transaction_id}
Este endpoint permite atualizar as informações de uma transação de pagamento da order.
Parâmetros de requisição
PATH
order_id
string

OBRIGATÓRIO

ID da order a ser atualizada. Esse valor é retornado na resposta à requisição Criar order.
transaction_id
string

OBRIGATÓRIO

Identificador da transação de pagamento que será atualizada na order. Este ID é gerado automaticamente pelo Mercado Pago na criação da requisição ou quando a transação for adicionada porteriormente à order.
BODY
payment_method
object

OBRIGATÓRIO

Informação sobre o meio de pagamento. Utilize o endpoint '/v1/payment_methods' para acessar a lista completa de meios de pagamento disponíveis. Esse recurso fornece detalhes sobre cada meio, incluindo suas propriedades.
Parâmetros de resposta
id
string
É o 'transaction_id'. Identificador da transação de pagamento que teve informações atualizadas.
amount
string
Valor da transação. Caso seja utilizado apenas um meio de pagamento, este deverá ser equivalente ao valor informado no campo "total_amount". Se forem utilizados dois, é a soma dos "amount" que deve ser equivalente ao val...Ver mais
payment_method
object

OBRIGATÓRIO

Informação sobre o meio de pagamento. Utilize o endpoint '/v1/payment_methods' para acessar a lista completa de meios de pagamento disponíveis. Esse recurso fornece detalhes sobre cada meio, incluindo suas propriedades.
Erros

400Erro. ID inválido.

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.

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.

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 já foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.

500Erro genérico.

500

Erro genérico. Tente realizar uma nova requisição.

Requisição
curl -X PUT \
    'https://api.mercadopago.com/v1/orders/{order_id}/transactions/{transaction_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    -d '{
  "payment_method": {
    "id": "visa",
    "type": "credit_card",
    "token": "12345",
    "installments": 1,
    "statement_descriptor": "approved"
  }
}'
Resposta de exemplo
{
  "id": "pay_01J49MMW3SSBK5PSV3DFR32959",
  "amount": "24.90",
  "payment_method": {
    "id": "visa",
    "type": "credit_card",
    "token": "12345",
    "installments": 1,
    "statement_descriptor": "approved"
  }
}