---
title: "Atualiza uma transação existente."
method: PUT
path: "/v1/transactions/{id}"
tags: ["transactions"]
---

# Atualiza uma transação existente.

`PUT /v1/transactions/{id}`

Utilize este método para atualizar o atributo "Nosso número" (`gateway_transaction_id`) em transações pendentes emitidas usando boleto bancário. Esta atualização é possível apenas caso o método de pagamento em questão não utilize a sequência autoincrementável da transação.

## Path parameters

- `id` integer, required

## Request body

- PutV1Transactions — Atualiza uma transação existente.
  - `body` string — JSON com os novos atributos da transação.
  - `gateway_transaction_id` string, required — ID do gateway remoto

## Response `200`

Transação atualizada com sucesso.

- Transaction — Este método permite verificar se um perfil de pagamento existente é válido na entidade emissora. Apenas o método de pagamento cartão de crédito suporta esta operação. Utilize esta função para validar um perfil de pagamento antes da criação de uma assinatura que não possua cobrança imediata. Este método é desnecessário para assinaturas com cobrança imediata. #### Funcionamento Preferencialmente a plataforma Vindi irá executar o método de validação fornecido nativamente pelas adquirentes. Caso este método não esteja disponível, a plataforma poderá realizar uma autorização seguida de um cancelamento. #### Resultado Para verificar o resultado da validação, verifique no retorno se `status=success`. #### Disponibilidade Esta funcionalidade estará disponível para testes enquanto sua conta Vindi estiver no modo trial. Para habilitar no modo produção, instale a extensão "Transação de verificação" acessando ***Configurações > Extensões & Integrações*** no painel de administração da plataforma. Taxas adicionais por verificação poderão ser cobradas.
  - `id` integer, required — ID da transação
  - `transaction_type` 'charge' | 'refund' | 'authorization' | 'capture' | 'verify' | 'register' | 'void' | 'renew_payment_profile' | 'pre_authorization' | 'update', required — Tipo da transação
  - `status` 'processing' | 'success' | 'rejected' | 'failure' | 'timeout' | 'waiting' | 'canceled' | 'fraud_review', required — Status da transação
  - `amount` number, required — Valor da transação
  - `installments` integer, required — Número de parcelas
  - `gateway_message` string, required — Mensagem de resposta do gateway
  - `gateway_response_code` string, required — Código de resposta do gateway
  - `gateway_authorization` string, required — Código da autorização usado no estorno ou captura. Varia de acordo com o adquirente
  - `gateway_transaction_id` string, required — Código externo de referência do gateway. Para boletos, representa o "nosso número"
  - `gateway_response_fields` string — Atributos de resposta específicos do gateway
  - `fallback_type` string, required — Tipo de Retentativa
  - `fraud_detector_score` number — Pontuação da análise antifraude entre 0.00 e 1.00. Quanto maior a pontuação, maior o risco de fraude
  - `fraud_detector_status` 'automatic_success' | 'manual_success' | 'automatic_rejected' | 'manual_rejected' | 'review' | 'failure' — Status da análise antifraude
  - `fraud_detector_id` string — ID da análise antifraude
  - `created_at` string, required — Data e hora da transação
  - `updated_at` string, required — Data e hora da última atualização da transação
  - `gateway` GatewaySummary, required
    - `id` integer, required — ID do gateway
    - `connector` string, required — Conector utilizado no gateway
  - `payment_profile` PaymentProfileSummary, required
    - `id` integer, required — ID do perfil de pagamento
    - `holder_name` string — Nome do titular/portador do perfil de pagamento
    - `registry_code` string — CPF ou CNPJ do titular/portador
    - `bank_branch` string — Agência da conta bancária
    - `bank_account` string — Número da conta bancária
    - `card_expiration` string — Validade do cartão de crédito no formato MM/AA
    - `allow_as_fallback` string — Permite utilizar o perfil de pagamento em retentativas de cobranças não pagas.
    - `card_number_first_six` string — Primeiros 6 dígitos do cartão de crédito (BIN/IIN)
    - `card_number_last_four` string — Últimos 4 dígitos do cartão de crédito
    - `renewed_card` object
      - `card_number_last_four` string — Últimos quatro dígitos do cartão de crédito renovado
      - `card_expiration` string — Nova validade do cartão de crédito renovado
    - `card_renewed_at` string — Data da renovação do cartão de crédito renovado
    - `token` string, required — Token interno para referência do perfil de pagamento
    - `created_at` string, required — Data e hora do cadastro do perfil de pagamento
    - `payment_company` PaymentCompany, required
      - `id` integer, required — ID da bandeira ou banco
      - `name` string, required — Nome da bandeira ou banco
      - `code` string, required — Código para referência via API
  - `charge` ChargeSummary, required
    - `id` integer, required — ID da cobrança
  - `customer` CustomerSummary, required
    - `id` integer, required — ID do cliente
    - `name` string, required — Nome do cliente
    - `email` string — E-mail do cliente
    - `code` string — Código opcional para referência via API
  - `payment_method` PaymentMethodSummary, required
    - `id` integer, required — ID do método de pagamento
    - `public_name` string, required — Nome público do método de pagamento
    - `name` string, required — Nome interno do método de pagamento
    - `code` string, required — Código externo para referência via API
    - `type` string, required — Tipo do método de pagamento

## Other responses

- `400` — Erro de sintaxe JSON no corpo do request.
- `404` — Transação não encontrada.
- `422` — Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost.md) · [All operations](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vindi/001-vindi-pagamentos-agost/revisions/9d11e5de9308/schema)