Gestão de Contas (parceiro)

Atualização de Status de Conta

Atualize o status de contas digitais através da API BaaS

Atualização de Status de Conta

O módulo de atualização de status permite modificar o status de contas digitais. Este módulo está disponível após a conclusão do onboarding e criação da conta.

Visão Geral

Através deste módulo você pode:

  • Atualizar o status de uma conta digital
  • Verificar o status atual de uma conta
  • Gerenciar estados de contas (ativa, bloqueada, encerrada, etc.)

Autenticação

Todas as rotas de atualização de status requerem:

  • Token JWT no header Authorization (autenticação auth:api)
  • Assinatura HMAC no header X-Signature (middleware hmac-signature)

Status Disponíveis

StatusDescrição
activeConta ativa e operacional
blockedConta bloqueada temporariamente
suspendedConta suspensa
closedConta encerrada
under_reviewConta em análise

Endpoints Disponíveis

Nota: Os endpoints específicos de atualização de status serão documentados conforme disponibilidade na API. Atualmente, o status da conta é gerenciado automaticamente pelo sistema baseado em operações e validações.

Consultar Status da Conta

O status da conta pode ser consultado através do endpoint de Listar Contas ou Consultar Conta Específica.

Regras de Negócio

Mudanças Automáticas de Status

O sistema atualiza automaticamente o status da conta baseado em:

  • Operações Financeiras: Transações pendentes podem alterar temporariamente o status
  • Validações: Contas em processo de validação ficam com status under_review
  • Bloqueios: Contas com problemas de segurança ou compliance podem ser bloqueadas
  • Encerramento: Contas encerradas através do endpoint de exclusão ficam com status closed

Status e Operações

  • active: Permite todas as operações (pagamentos, transferências, consultas)
  • blocked: Bloqueia operações de saída, permite consultas
  • suspended: Bloqueia todas as operações exceto consultas básicas
  • closed: Não permite nenhuma operação
  • under_review: Operações limitadas até conclusão da análise

Próximos Passos

Após verificar o status da conta, você pode:

  1. Listar Contas para verificar status de múltiplas contas
  2. Encerrar uma Conta se necessário
  3. Consultar Relatórios para monitorar a conta

2025 © Nuvende - CNPJ 38.297.374/0001-93