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-7434*********159-03141*********cee51edf8*********f94f589-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"
  }
}