---
title: "Atualiza um vínculo."
method: PUT
path: "/pix/indireto/dict/vinculo/{chave}"
tags: ["Diretorio"]
---

# Atualiza um vínculo.

`PUT /pix/indireto/dict/vinculo/{chave}`

## Request

- Base URL: `https://example.com`
- URL: `https://example.com/pix/indireto/dict/vinculo/{chave}`
- Auth: none required

<br>A ser utilizado no cenário de atualização da informação da conta, nome e nome fantasia de um cliente, permanecendo este no mesmo PSP. 
            Somente podem ser atualizadas as informações de conta do vínculo, nome e nome fantasia do cliente. Outras atualizações do vínculo devem ser 
            feitas por exclusão/inclusão do vínculo, portabilidade ou reivindicação de posse, a depender da situação.
<br>
  <b>Restrições</b>

<br>As seguintes restrições devem ser obedecidas na atualização de vínculo, de acordo com o tipo de chave:
<list type="bullet">
  <item>Chaves `EVP` (aleatórias) - É permitida a alteração, porém, apenas com os motivos `BRANCH_TRANSFER` ou 
              `RECONCILIATION`.</item>
  <item>Demais chaves - É permitida a alteração com os motivos `USER_REQUESTED`, `BRANCH_TRANSFER` ou 
              `RECONCILIATION`.</item>
</list>

## Path parameters

- `chave` string, required

## Headers

- `api-version` string, required
- `Authorization` string, required

## Request body

- Bs2Core2PixIndiretoDictAppApisDictDiretorioAtualizarVinculoAtualizarVinculo: Representa o corpo de uma requisição para atualização de um vínculo de chave com conta transacional já existente.
  - `contaTransacional` Bs2Core2PixIndiretoDictAppApisCompartilhadosContaTransacionalPix: Representa uma conta transacional do Pix no DICT.
    - `ispb` string, nullable: Retorna ou define o número do Identificador de Sistema de Pagamentos Brasileiro do participante responsável da requisição.
    - `agencia` string, nullable: Retorna ou define o número da Agência, sem o dígito verificador
    - `numeroConta` string, nullable: Retorna ou define o número da Conta, incluindo o dígito verificador. Se o dígito verificador for uma letra, deve substituir por 0.
    - `tipo` 'Corrente' | 'Salario' | 'Poupanca' | 'Pagamento': Representa o tipo de conta de débito ou crédito do Pix segundo as especificações da ISO 20022.
    - `dataAbertura` string, date-time, nullable: Retorna ou define a data de abertura da conta. Para o horário, caso não seja conhecido, convenciona-se o início do dia em BRT (00:00:00).
  - `participante` Bs2Core2PixIndiretoDictAppApisCompartilhadosProprietario: Representa uma pessoa física ou pessoa jurídica, participante de uma conta transacional de Pix no DICT.
    - `tipo` 'PessoaFisica' | 'PessoaJuridica': Representa o tipo do dono da solicitação ou da chave de endereçamento Pix no DICT.
    - `nome` string, nullable: Retorna ou define o nome da pessoa física participante da contra transacional.
    - `documento` string, nullable: Retorna ou define o número do CPF da pessoa física participante do Pix ou o número do CNPJ da pessoa jurídica participante do Pix.
    - `nomeFantasia` string, nullable: Retorna ou define o nome fantasia da pessoa jurídica participante do Pix.
  - `razao` 'SolicitacaoUsuario' | 'FechamentoConta' | 'TransferenciaAgencia' | 'Reconciliacao' | 'Fraude': Representa o tipo definindo os motivos de criação, atualização, remoção, reivindicação de posse ou reivindicação de portabilidade de vínculos de chaves de endereçamento do Pix no DICT.

## Response `200`

Quando a atualização do vínculo for executada com sucesso.

- Bs2Core2PixIndiretoDictAppApisDictDiretorioAtualizarVinculoVinculoAtualizado: Representa as informações de um vínculo já existente que foi atualizado no DICT.
  - `correlationId` string, nullable: Retorna ou define o identificador de correlação para o suporte operacional do DICT.
  - `vinculo` Bs2Core2PixIndiretoDictAppApisCompartilhadosVinculoChavePix: Representa um vínculo entre uma chave de endereçamento do Pix no DICT, uma conta transacional e seu dono.
    - `chavePix` Bs2Core2PixIndiretoDictAppApisCompartilhadosChavePix: Representa uma chave de endereçamento Pix de um participante direto ou indireto no DICT.
      - `tipo` 'CPF' | 'CNPJ' | 'Telefone' | 'Email' | 'Aleatoria': Representa o tipo da chave Pix.
      - `chave` string, nullable: Retorna ou define a chave de endereçamento do participante.
    - `contaTransacional` Bs2Core2PixIndiretoDictAppApisCompartilhadosContaTransacionalPix: Representa uma conta transacional do Pix no DICT.
      - `ispb` string, nullable: Retorna ou define o número do Identificador de Sistema de Pagamentos Brasileiro do participante responsável da requisição.
      - `agencia` string, nullable: Retorna ou define o número da Agência, sem o dígito verificador
      - `numeroConta` string, nullable: Retorna ou define o número da Conta, incluindo o dígito verificador. Se o dígito verificador for uma letra, deve substituir por 0.
      - `tipo` 'Corrente' | 'Salario' | 'Poupanca' | 'Pagamento': Representa o tipo de conta de débito ou crédito do Pix segundo as especificações da ISO 20022.
      - `dataAbertura` string, date-time, nullable: Retorna ou define a data de abertura da conta. Para o horário, caso não seja conhecido, convenciona-se o início do dia em BRT (00:00:00).
    - `proprietario` Bs2Core2PixIndiretoDictAppApisCompartilhadosProprietario: Representa uma pessoa física ou pessoa jurídica, participante de uma conta transacional de Pix no DICT.
      - `tipo` 'PessoaFisica' | 'PessoaJuridica': Representa o tipo do dono da solicitação ou da chave de endereçamento Pix no DICT.
      - `nome` string, nullable: Retorna ou define o nome da pessoa física participante da contra transacional.
      - `documento` string, nullable: Retorna ou define o número do CPF da pessoa física participante do Pix ou o número do CNPJ da pessoa jurídica participante do Pix.
      - `nomeFantasia` string, nullable: Retorna ou define o nome fantasia da pessoa jurídica participante do Pix.
  - `dataCriacao` string, date-time: Retorna ou define a data de criação do vínculo.
  - `dataPosse` string, date-time: Retorna ou define a data a partir da qual o dono tem posse ininterrupta da chave de endereçamento. A posse da chave aqui é definida pela existência de um vínculo associando a chave ao dono, possivelmente com contas distintas.
  - `dataAberturaReivindicacao` string, date-time, nullable: Retorna ou define a data da abertura do processo de reivindicação de posse ou portabilidade, caso a chave esteja possua um destes processos abertos no momento.

## Other responses

- `400`: Quando o corpo da requisição de atualização de vínculo é inválido.
- `403`: Quando houver erros e/ou violações de acesso na requisição de atualização de vínculo.
- `404`: Quando o vínculo a ser atualizado não for encontrado.
- `503`: Quando a API do DICT não respondeu em tempo hábil e retorna o número de segundos necessário para a próxima tentativa de requisição

---

[API](https://skmtc.dev/bs2/apis/api-dict.md) - [All operations](https://skmtc.dev/bs2/apis/api-dict/llms.txt) - [OpenAPI document](https://skmtc.dev/bs2/apis/api-dict/revisions/6f6959388685?raw)