Gestão de Contatos e Favoritos

Visão geral

A funcionalidade de Gestão de Contatos e Favoritos permite cadastrar e gerenciar destinatários para transações futuras, facilitando a realização de novas operações.

Por meio dessa funcionalidade, o cliente pode cadastrar, consultar, favoritar, desfavoritar e remover contatos vinculados a uma conta. O contato pode ser cadastrado como comum ou marcado como favorito no momento do cadastro ou posteriormente.

A classificação do contato influencia os limites transacionais aplicáveis às operações, conforme as regras de segurança definidas para cada modalidade.

Contato comum x favorito

A principal diferença entre um contato comum e um favorito está na aplicação dos limites transacionais.

Característica	Contato comum	Favorito
Identificação	`isFavorite: false`	`isFavorite: true`
Finalidade	Destinatário salvo para facilitar novas transferências.	Destinatário identificado como de confiança.
Limite transacional	Segue as regras de limite aplicáveis a terceiros.	Passa a utilizar os limites específicos para favoritos após a conclusão do prazo de aprovação interna.
Prazo de ativação	Não informado para contato comum.	Padrão de 24 horas, configurável por cliente.

Prazo de ativação de favorito

Ao cadastrar um contato como favorito ou favoritar um contato existente, a aplicação dos limites específicos de favoritos não ocorre imediatamente. É necessário aguardar o prazo de aprovação interna, configurado por padrão em 24 horas.

Durante esse período, o contato ainda não usufrui dos limites diferenciados de favorito.

Esse mecanismo é uma medida de segurança: caso uma conta seja comprometida, um destinatário recém-cadastrado ou recém-favoritado não passa a ter acesso imediato aos limites mais elevados destinados a favoritos.

Funcionalidades disponíveis

A Gestão de Contatos e Favoritos contempla as seguintes operações:

Cadastrar contato comum: incluir um destinatário sem classificá-lo como favorito.
Cadastrar contato na transação Pix: durante uma operação de pix-out, o cliente poderá informar se deseja cadastrar o destinatário como contato e vinculá-lo como favorito.
Consultar contatos: listar os contatos cadastrados para uma conta.
Remover Contato da Conta: remover um contato vinculado a uma conta
Alterar favorito: Permite marcar ou desmarcar um contato cadastrado como favorito e, opcionalmente, alterar seu apelido (alias), por meio de um endpoint.

Observações importantes:

Um contato comum não é automaticamente considerado favorito.

A classificação como favorito pode ocorrer no cadastro ou posteriormente.

A aplicação dos limites de favorito depende da conclusão do prazo de aprovação interna, que é por padrão 24 horas

Nas próximas páginas, cada operação será detalhada individualmente, incluindo endpoint, parâmetros, exemplos de requisição e resposta e regras de negócio aplicáveis.