Pular para o conteúdo principal

Configurações

O menu Configurações, disponível em CADASTROS E CONTA, concentra as opções de administração da conta relacionadas aos usuários com acesso à conta, à consulta dos limites vigentes e às adesões de produtos.

O menu é dividido em três abas:

  • PERMISSÕES
  • MEUS LIMITES
  • ADESÕES

As credenciais, os webhooks e a documentação das APIs passaram a ser administrados na área Desenvolvedor, no mesmo grupo do menu — a própria tela de Configurações apresenta o aviso "Credenciais e webhooks mudaram de lugar", informa que "As abas API QRCodes, API Contas e API BaaS agora ficam em Desenvolvedor, junto com os logs de API e a documentação." e oferece o atalho Ir para Desenvolvedor. Essa área é descrita na seção Desenvolvedor, abaixo.

Importante: este guia explica como administrar essas configurações no sistema. O uso dos endpoints, os detalhes de conexão e a integração técnica das APIs devem ser consultados na documentação específica das APIs.

Tela Configurações com o aviso de que as abas de API agora ficam em Desenvolvedor

Desenvolvedor​

O item Desenvolvedor, disponível em CADASTROS E CONTA e identificado com o selo Novo, reúne os recursos de integração da conta: "Logs das APIs, credenciais, webhooks e documentação da sua integração." No topo da tela fica o atalho Ver tour.

A área é dividida em cinco abas, conforme observado em 08/10/2026:

  • VISÃO GERAL — indicadores de uso das APIs, com os recortes 24 h, 7 dias e 30 dias e o seletor de API (Todas, Contas e QRCodes). Quando a coleta de logs não está ligada para a instituição, a aba apresenta "Logs de API indisponíveis neste ambiente" e "A coleta de logs das APIs ainda não foi ligada para esta instituição."
  • LOGS DE API — consulta dos requests registrados, com os filtros PERÍODO (Última hora, Últimas 24 horas, Últimos 7 dias, Últimos 30 dias e Personalizado), API, CREDENCIAL (apresentado nas contas com credenciais cadastradas), STATUS (Todos, 2xx, 3xx, 4xx e 5xx), CÓDIGO HTTP, MÉTODO (GET, POST, PUT, PATCH e DELETE), ROTA e REQUEST ID, além de Filtrar e Limpar; sem coleta ligada, a lista informa "Logs de API indisponíveis neste ambiente".
  • WEBHOOKS — webhooks das APIs de QR Codes e de Contas, nas abas API QRCODES e API CONTAS.
  • CREDENCIAIS — credenciais das APIs, nas abas API QRCODES, API CONTAS e API BAAS.
  • DOCUMENTAÇÃO — endereços de URL DA API e POST TOKEN de cada API, com os atalhos Referência da API e Autenticação, e os guias Certificado mTLS, Ambiente sandbox, Portal do desenvolvedor e Rastrear um request.

A composição da área acompanha as funcionalidades liberadas para a conta. No ambiente observado em 11/10/2026, com a geração de credenciais não habilitada, a área apresentava as abas VISÃO GERAL, LOGS DE API, CREDENCIAIS e DOCUMENTAÇÃO: a aba WEBHOOKS não era exibida e o acesso direto à sua rota informava "Você não tem acesso a esta página" e "Peça ao administrador da sua instituição o acesso a esta funcionalidade."; a aba CREDENCIAIS apresentava "Funcionalidade não habilitada" e "A geração de credenciais não está habilitada para sua conta. Entre em contato com nossa instituição para solicitar a liberação desta funcionalidade."; e a aba DOCUMENTAÇÃO apresentava os atalhos Referência da API e Autenticação das APIs de Contas e de QRCodes e os quatro guias, sem os endereços de URL DA API e POST TOKEN.

Na medição de 12/10/2026, com a geração de credenciais habilitada, a área voltou a apresentar as cinco abas e as áreas CREDENCIAIS e WEBHOOKS responderam normalmente: a CREDENCIAIS exibia a lista Credenciais API com as credenciais da conta e a WEBHOOKS, as sub-abas API QRCODES e API CONTAS com a lista dos tipos de evento.

Na aba CREDENCIAIS, cada API tem a sua aba e a tela apresenta Credenciais API, os botões Documentação e Nova credencial, o bloco COMO CONECTAR NA API (com URL DA API e POST TOKEN) e a lista com as colunas Descrição · Credencial · Status · IPs permitidos · Ações. A criação e a administração das credenciais seguem o fluxo descrito em API QRCODES e API CONTAS.

API QRCODES​

A aba API QRCODES da área Desenvolvedor permite administrar as credenciais (em CREDENCIAIS) e os webhooks (em WEBHOOKS) utilizados pela integração da API de QR Codes.

Acessar a documentação da API​

Clique em Documentação para consultar a documentação técnica da API.

A documentação de endpoints e integração não faz parte do escopo deste guia.

Na mesma aba, o bloco COMO CONECTAR NA API PIX apresenta a URL DA API e o endereço de POST TOKEN da conta. O texto do bloco informa que o handshake exige o certificado cliente (mTLS) e que, no token, devem ser enviados grant_type=client_credentials, client_id e client_secret.

Criar uma nova credencial​

Use Nova credencial para gerar uma credencial de acesso à API. A lista de cada API admite até 5 credenciais ativas; com esse limite atingido, a tela informa "Limite de 5 credenciais ativas. Revogue uma para gerar outra." e o botão Nova credencial não fica disponível até que uma credencial seja revogada.

A janela abre com o bloco Certificado desta credencial — "Cada credencial tem o próprio certificado (PFX). Use o arquivo baixado com esta credencial. Um certificado antigo falha com onz-0001. A credencial, os IPs e o PFX saem no mesmo passo. Guarde o arquivo e a senha; eles não serão exibidos novamente."

Preencha os campos solicitados:

  1. Descrição — informe uma identificação para a credencial.
  2. Permissões da credencial — selecione os escopos que a credencial poderá utilizar. O título da seção informa a quantidade de linhas apresentadas ("Permissões da credencial (27)"), contando a linha Todas as permissões; na medição de 17/10/2026 eram 26 escopos, com o par Location de recorrência - Leitura e Location de recorrência - Escrita repetido duas vezes. O botão Ativar todas seleciona todos de uma vez — quando todos estão marcados, ele passa a Desativar todas.
  3. IPs permitidos — o formulário já abre com uma linha; informe os IPs autorizados a utilizar a credencial, em IPv4 (192.168.1.1) ou em faixa (192.168.1.0/24). O campo também aceita faixa IPv6, como no exemplo indicado na própria tela (192.168.1.1, 10.0.0.0/24 ou 2a09:bac0::/29). Para incluir outro IP, use Adicionar IP — cada linha adicional pode ser removida pelo ícone de fechar. Com os campos vazios, o Gerar mantém a janela aberta e a credencial não é gerada: o campo de IP exibe "IP é obrigatório" e, sob a DESCRIÇÃO, o sistema indica "Informe a descrição".

Depois de preencher os campos, clique em Gerar. A credencial é criada e a tela da credencial é aberta, com CLIENT ID, CLIENT SECRET e CHAVE PIX à vista. No topo, o sistema avisa "Client secret e senha do PFX aparecem só nesta visita." e, no bloco Credencial, "Copie o client secret antes de sair." — os três valores têm ícone de cópia ao lado e não são apresentados de novo depois que a tela é deixada. Na mesma visita, a seção Certificados apresenta o certificado emitido no próprio Gerar, com a SENHA DO PFX e o botão Baixar certificado (.pfx).

Atenção: a credencial e os IPs passam a valer nesse mesmo processo, e CLIENT ID, CLIENT SECRET e CHAVE PIX são apresentados uma única vez, na tela da credencial logo após o Gerar — guarde essas informações em local seguro, pois não serão exibidas novamente.

Nova credencial da API QRCODES

Administrar as credenciais​

Depois de criada, a credencial aparece na lista Credenciais API.

A lista apresenta:

  • Descrição
  • Credencial
  • Status — Ativa ou Inativa
  • IPs permitidos
  • Ações

Nas ações da credencial, estão disponíveis:

  • Copiar Client ID — copia o identificador da credencial.
  • Ver credencial — abre a tela da credencial selecionada.
  • Revogar credencial — pede confirmação na janela Revogar credencial, com o aviso "Ao revogar, o certificado desta credencial será revogado e deixará de funcionar.", entre Cancelar e Sim, revogar; depois da confirmação o sistema apresenta "Credencial revogada." e a credencial deixa de ser listada.

A lista apresenta somente credenciais Ativa, e cada linha traz as três ações descritas. A credencial revogada não é apresentada na lista; na tela dela, o STATUS passa a Inativa e o certificado, a Revogado. A lista é recarregada pelo botão de ícone Atualizar credenciais.

Consultar a credencial​

A tela da credencial traz o nome da credencial no topo e as seções:

  • Credencial — "Identificação e acesso desta credencial.", com DESCRIÇÃO, STATUS, CLIENT ID e IPS PERMITIDOS. Sob os IPs, a tela informa que os IPs permitidos ficam gravados no certificado mTLS e que a credencial não pode ser alterada: para trocar IPs, permissões ou certificado, é preciso revogar esta credencial e criar outra.
  • Certificados — com CN, STATUS e VÁLIDO ATÉ quando há certificado vinculado. Na credencial recém-criada a seção apresenta o certificado emitido no próprio Gerar, com o aviso "Baixe o arquivo nesta visita. A chave privada não volta.", o bloco PFX desta credencial com a orientação "Cada credencial tem o próprio certificado (PFX). Use o arquivo baixado com esta credencial. Um certificado antigo falha com onz-0001.", a SENHA DO PFX e o botão Baixar certificado (.pfx) — o arquivo baixado leva o CN no nome (no exemplo observado, 991199_17-mtls.pfx); ao reabrir a credencial, a seção informa "Cada credencial tem o próprio certificado. Use o PFX baixado com ela; um arquivo antigo falha com onz-0001." e o botão de download não é exibido. Na credencial revogada o STATUS do certificado passa a Revogado. Sem certificado vinculado, a seção informa "Nenhum certificado emitido." (situação medida em 29/09/2026, em credencial criada naquele dia).
  • Auditoria — "Quem alterou esta credencial."; sem alteração registrada, a tela apresenta "Nenhum evento registrado." e, com eventos, cada linha traz a ação, a data e o IP de origem — o registro observado em 02/10/2026 sai como "Criou credencial de API «...»", seguido da data e da hora (01/10/2026, 20:04) e do IP de origem. A revogação acrescenta a linha "Deletou credencial de API «...»", com a data, a hora e o IP da operação.
  • Primeiros passos — "Como autenticar o primeiro request.", com URL DA API, URL DO TOKEN e as orientações de instalação do PFX, de conferência do IP de origem, de obtenção do token e de uso do access_token. As orientações acompanham o estado da credencial: na credencial recém-criada elas indicam "Baixe o PFX desta credencial e copie a senha. A chave privada e a senha só aparecem agora. Um certificado antigo falha com onz-0001."; ao reabrir a credencial, passam a "Use o PFX baixado com esta credencial. Certificado de outra credencial (ou um PFX antigo) falha com onz-0001."; sem certificado, indicam usar o client_id e o client_secret guardados na criação. A seção fecha com o aviso "Credenciais de sandbox não valem em produção."

No alto da tela ficam o botão Revogar, que executa a mesma revogação descrita em Administrar as credenciais, e o botão Ver credencial, que abre a janela Detalhes da credencial da sua conta, com o CLIENT ID, a situação (Ativa), os IPs permitidos e a lista de Permissões, encabeçada pela linha Todas as permissões e com cada escopo marcado como Habilitada ou Não habilitada; a janela também traz o botão Copiar Client ID e o bloco Auditoria, com o registro de criação da credencial.

Os valores apresentados nas seções acompanham ícones de cópia — Client ID, CN, URL da API e URL do token. No fim da tela, atalhos abrem a documentação de Autenticação, Certificado mTLS, Sandbox e Referência da API.

Credencial exibida

Configurar webhooks​

A seção Webhooks permite cadastrar a URL que receberá os avisos automáticos enviados pela API.

Os webhooks já cadastrados são apresentados em uma lista, com busca, Limpar, Configurar colunas e Atualizar no alto e paginação; a tela informa "O webhook é a URL cadastrada. O histórico mostra os disparos já feitos e fica retido por até 15 dias." Quando não há nenhum cadastro, a tela mostra "Nenhum item encontrado".

Clique em Configurar e preencha:

  • TIPO — as opções são Cobrança, Pix Automático - Cobrança e Pix Automático - Recorrência. A tela informa que a cobrança imediata usa uma chave Pix da conta e que o Pix Automático vale para a conta toda, sem chave.
  • CHAVE PIX — apresentado quando o tipo é Cobrança: informe a chave da conta. A tela informa que só chaves Pix registradas nesta conta podem ser utilizadas.
  • URL — informe o endereço do sistema que receberá os avisos.
  • Clique em Salvar para concluir.

Após a confirmação, a janela é fechada e a tela exibe o aviso "Webhook salvo".

Nos tipos Pix Automático - Cobrança e Pix Automático - Recorrência, o campo CHAVE PIX não é apresentado e a tela exibe o aviso "Um webhook por tipo. Salvar substitui a URL atual."

O histórico dos disparos fica disponível no próprio menu e é retido por até 15 dias.

Administrar um webhook cadastrado​

Cada linha da lista é um webhook cadastrado — Status · Chave · Tipo · URL · Criação — e apresenta as ações:

  • Reenviar webhooks do período — reenvia os disparos já feitos no período escolhido.
  • Editar — altera o cadastro do webhook.
  • Remover — altera o status do webhook para Removido; a janela informa "Este webhook passa a Removido. Não há pausa — para receber de novo, configure outra vez."
  • Histórico de webhooks — abre o histórico dos disparos do webhook.

Como só existe um webhook por tipo, cadastrar de novo o mesmo tipo substitui a URL atual em vez de criar uma segunda linha.

Webhooks da API QRCODES

Configurar webhook

Opções de tipo do webhook

API CONTAS​

A aba API CONTAS, em Desenvolvedor, possui a mesma estrutura básica para administração das credenciais (CREDENCIAIS) e dos webhooks (WEBHOOKS) da API de Contas.

Criar e administrar credenciais​

Em API CONTAS, estão disponíveis:

  • Documentação
  • Nova credencial
  • Credenciais API

Ao criar uma credencial, o sistema apresenta o mesmo fluxo de administração descrito na aba API QRCODES. O que muda é a lista de escopos, própria da API de Contas: Pix (leitura, escrita e criação), Contas, Webhooks, Transações, Boletos (leitura, escrita e criação), Infrações, TED (leitura, escrita e criação), Transf. internas (leitura, escrita e criação), Cobranças, CryptoRisk, CaaS, Bancarização e Crédito consignado trabalhador.

Na aba, o bloco COMO CONECTAR NA API DE CONTAS apresenta a URL DA API e o POST TOKEN, com a mesma exigência de certificado cliente (mTLS). Na lista Credenciais API, a coluna Credencial exibe o client ID da credencial.

Na lista de credenciais, estão disponíveis as ações:

  • Copiar Client ID
  • Ver credencial
  • Revogar credencial

Credenciais da API de Contas

Configurar webhooks por tipo de evento​

Na seção de webhooks da API CONTAS, cada tipo de evento é apresentado separadamente.

Os tipos disponíveis são:

  • Transferência
  • Recebimento
  • Estorno
  • Fila de Saída de Pagamentos
  • Infrações
  • Cripto

Para cada tipo, a tela apresenta o Status, o campo Ativo e a URL cadastrada — as colunas da lista são Tipo · Status · Ativo · URL. A última coluna, sem título, reúne as ações do tipo: Reenviar webhooks do período, Testar URL, Editar, Ativar e Remover. No alto da seção ficam os botões Reenviar webhooks do período e Histórico de webhooks.

Quando ainda não existe uma URL configurada, o evento aparece como Não Configurado, com status Pausado e URL NÃO CONFIGURADO, e as ações Ativar e Remover ficam desabilitadas; nesse estado a ação Testar URL não é apresentada e Reenviar webhooks do período aparece como botão de texto na própria linha.

Webhooks da API de Contas por tipo

Editar um webhook por tipo de evento​

Selecione Editar na linha do tipo para abrir a janela do webhook daquele tipo — Webhook de Transferência, no exemplo observado — e informe:

  • URL * — endereço do sistema que receberá os avisos.
  • EMAIL PARA NOTIFICAÇÃO DE ERROS * — e-mail que receberá a notificação de erros.
  • Pausar este webhook — pausa o webhook deste tipo.
  • Pausar webhook ao detectar falha — pausa o webhook quando uma falha é detectada.
  • MÉTODO * — GET, POST ou PUT.
  • Headers — Adicionar header inclui um par de campos, [chave] e [valor]. Sem nenhum header incluído, a tela mostra "- Nenhum header adicionado -".

Na janela observada, as duas opções de pausa aparecem marcadas. Clique em Salvar para concluir.

Editar o webhook de um tipo de evento

Reenviar webhooks de um período​

O recurso Reenviar webhooks do período permite colocar novamente na fila os disparos de um intervalo específico.

Como funciona: todos os webhooks ativos da conta entram na fila. Webhooks pausados são ignorados. Mesmo os disparos que já foram entregues são reenfileirados.

O botão está disponível na seção Webhooks, na linha de cada tipo de evento e também no alto da tela Histórico de webhooks. No tipo cujo webhook está cadastrado e pausado, a ação da linha fica desabilitada e a janela não abre; no tipo ainda Não Configurado, a ação fica habilitada e a janela abre com o bloco Webhook pausado — "Reative este webhook antes de reenviar." — e a prévia do período. A seção explica o que será reenviado — "O que será reenviado", "Todos os webhooks ativos da conta entram na fila. Webhooks pausados são ignorados. Disparos já entregues também são reenfileirados.", "Intervalo máximo de 2 dias." e "Histórico retido por até 15 dias."

Para realizar o reenvio:

  1. Informe o INÍCIO DO PERÍODO e o FIM DO PERÍODO — por padrão, o dia atual, das 00:00 às 23:59.
  2. Respeite o limite máximo de 2 dias de intervalo por reenvio. Com um período maior, o sistema não apresenta a prévia: o bloco Prévia do período deixa de ser exibido, sem mensagem de aviso, e o botão de reenvio permanece desabilitado — no exemplo observado, de 01/10/2026 00:00 a 19/10/2026 23:59. Com exatamente 2 dias de intervalo, a prévia volta a aparecer.
  3. Consulte a prévia apresentada pelo sistema. Ela informa a quantidade de webhooks no período, separando os registros em entregues, falhos, aguardando e enviando — por exemplo, "0 disparos neste intervalo (0 entregues, 0 falhos, 0 aguardando, 0 enviando)."
  4. Confira os valores apresentados e, se necessário, ajuste o período.
  5. Clique em Reenviar webhooks do período para colocar os disparos novamente na fila. O botão só fica habilitado quando a prévia informa disparos no intervalo — no exemplo observado com 2 disparos, "2 disparos neste intervalo (0 entregues, 0 falhos, 2 aguardando, 0 enviando)."; sem disparos no intervalo, "0 disparos neste intervalo (0 entregues, 0 falhos, 0 aguardando, 0 enviando)." e o botão permanece desabilitado.

O histórico disponível para esse recurso é retido por até 15 dias.

Reenviar webhooks do período

Consultar o histórico de webhooks​

A tela Histórico de webhooks permite acompanhar os disparos realizados para a URL configurada na conta. Ela é aberta pelo botão Histórico de webhooks da seção Webhooks, em CADASTROS E CONTA → Desenvolvedor → WEBHOOKS → API CONTAS, e apresenta o subtítulo "Disparos registrados para a URL configurada na sua conta". A lista traz as colunas Status · Código HTTP · Tipo do webhook · Referência · Data do disparo · Ações.

No topo, o sistema apresenta os contadores de:

  • Webhooks ativos
  • Webhooks pausados
  • Aguardando disparo
  • Enviando
  • Entregue
  • Falhou

A tela também disponibiliza:

  • Busca
  • Filtro Avançado
  • Filtro de período: Hoje, 7d, 30d ou Selecionar período
  • Atualizar e a seleção de colunas

Os dados são retidos por até 15 dias, e a contagem exibida no topo considera as últimas 24 horas — a tela declara "Para alterar a URL, use a aba Webhooks. Histórico retido por até 15 dias. A contagem abaixo usa as últimas 24 horas."

Quando não houver registros no intervalo selecionado, o sistema exibirá:

Nenhum item encontrado — "Nenhum resultado para a data selecionada."

Histórico de webhooks

Observação: a aba API QRCODES de WEBHOOKS também possui uma tela própria de Histórico de webhooks, com o botão Reenviar webhooks, destinada aos disparos daquela chave. Nessa tela, a janela de reenvio pede DATA/HORA INICIAL e DATA/HORA FINAL — por padrão, o dia atual, das 00:00 às 23:59 — e a confirmação é feita em Sim, reenviar.

API BAAS​

A aba API BAAS apresenta a seção Credenciais API BaaS e o botão Nova credencial BaaS. Quando a conta não possui credencial cadastrada, a tela informa "Nenhuma credencial BaaS encontrada" (estado observado em 05/10/2026).

Credenciais da API BaaS

Criar uma credencial BaaS​

O botão Nova credencial BaaS abre a janela de cadastro, que informa "Credenciais BaaS permitem operar contas filhas do BaaS usando o header x-account-id nos endpoints da ApiV2." e apresenta os campos:

  • DESCRIÇÃO — identificação da credencial (obrigatório).
  • Permissões da credencial — escopos que a credencial poderá utilizar; o título da seção informa a quantidade de linhas apresentadas ("Permissões da credencial (24)", na medição de 19/10/2026) e Ativar todas marca todos de uma vez; com todos marcados, o botão passa a Desativar todas.
  • IPs permitidos — o formulário já abre com uma linha; Adicionar IP inclui outra.

Depois de preencher os campos, clique em Gerar.

A credencial é criada e a própria janela passa a apresentar o bloco Guarde agora, com o aviso "O client secret e a senha do PFX são exibidos somente neste momento.", o CLIENT ID e o CLIENT SECRET, cada um com o botão de cópia ao lado (Copiar Client ID e Copiar Client secret). Os valores são apresentados somente nessa visita: feche a janela em Fechar depois de guardá-los.

Administrar as credenciais BaaS​

Depois de criada, a credencial aparece na lista Credenciais API BaaS, com as colunas Descrição · Credencial · Status · IPs permitidos · Ações. A coluna Credencial exibe o client ID da credencial (prefixo baas_) e a coluna Status, a situação Ativa.

Nas ações da linha estão disponíveis:

  • Copiar Client ID — copia o identificador da credencial.
  • Editar — abre Editar permissões da credencial, com as mesmas permissões da criação e os IPs permitidos; Salvar aplica as alterações e Cancelar fecha sem alterar.
  • Atualizar credencial — pede confirmação na janela Atualizar credencial, com o aviso "Gerando novas credenciais, as credenciais atuais serão invalidadas." e a pergunta "Você deseja prosseguir?", entre Cancelar e Atualizar; ao confirmar, a janela Credenciais geradas com sucesso! apresenta o novo CLIENT SECRET com o aviso "Guarde essas credenciais em um local seguro, elas serão exibidas somente neste momento."
  • Excluir credencial — pede confirmação na janela Confirmação, com a pergunta "Deseja realmente excluir a credencial?", entre Cancelar e Sim, excluir; depois da confirmação o sistema apresenta "Credencial excluída com sucesso!" e a credencial sai da lista.

As ações Ver credencial e Revogar credencial, descritas nas abas API QRCODES e API CONTAS, não são apresentadas nessa aba.

Permissões​

A aba PERMISSÕES permite administrar os usuários que possuem acesso à conta.

No alto da listagem ficam Nova Permissão, o campo Buscar, Limpar, Avançado, Configurar colunas e Atualizar; no rodapé ficam a quantidade de itens por página (25, 50, 100 e 500) e o total de itens encontrados.

Cada usuário é apresentado com:

  • Nome
  • CPF
  • Cargo — por exemplo, Titular, Signatário e TI
  • Status — apresentado como selo, com o ícone de confirmação ao lado do texto
  • Data de criação
  • Data de expiração
  • Ações — botão de reticências, sem texto

A primeira coluna não tem título e traz o ícone de usuário de cada linha.

O botão Configurar colunas abre o seletor Colunas, com Todas as colunas e cada coluna da listagem marcada; Ações é a única que não pode ser desmarcada. Salvar aplica a seleção.

Permissões de acesso à conta

Conceder acesso a um usuário​

Para adicionar um usuário à conta, clique em Nova Permissão. A janela Nova permissão de acesso à conta traz o campo CPF DO USUÁRIO e os botões Cancelar e Conceder permissão.

  1. Informe o CPF DO USUÁRIO.
  2. Clique em Conceder permissão.

Importante: caso o CPF ainda não possua cadastro, o cadastro pode ser realizado pelo App, utilizando a opção Cadastro sem conta.

Nova permissão de acesso

Administrar o acesso de um usuário​

Na coluna Ações, é possível administrar o acesso de cada usuário:

  • Permissões — ajusta o que o usuário pode fazer.
  • Bloquear — suspende o acesso do usuário.
  • Remover — remove o usuário da conta.

Ações de um usuário

Ajustar as permissões de um usuário​

Ao selecionar Permissões nas ações da linha, o sistema abre a janela Permissões do usuário. No topo, ela identifica o usuário pelo nome, pelo cargo e pelo documento; em seguida, apresenta os grupos de permissão da conta:

  • Dashboard — permissões para acessar painéis, que fornecem uma visão geral das principais métricas e informações da conta.
  • Usuários — permissões para gerenciar usuários do sistema, incluindo a adição, o bloqueio e a exclusão de usuários, bem como a atribuição de permissões.
  • Transações — permissões relacionadas à criação, à visualização, à edição e ao cancelamento de transações financeiras dentro da aplicação.
  • Pagamento de Lotes — permissões para o processamento, a importação e a exportação de arquivos CNAB e transações em lote.
  • Infrações — permissões para visualizar, gerenciar e responder infrações relatadas no sistema.
  • QR Code — permissões para gerar, visualizar e gerenciar cobranças e pagamentos via Pix.
  • Credenciais — permissões para gerenciar credenciais e chaves de API utilizadas para autenticação e integração com outros sistemas e serviços.
  • Logs de API — permissões para consultar o histórico de requests das integrações, com a permissão Visualizar logs de API.
  • Webhooks — permissões para configurar, editar e monitorar webhooks.
  • Gerencia da conta — permissões para visualizar e gerenciar informações da conta.
  • Faturas — permissões para visualizar e gerenciar faturas.
  • Gestão BaaS — permissões para acompanhar contas, pessoas e transações dos clientes do BaaS e aprovar cadastros pendentes, com as permissões Visualização, Ações operacionais e Aprovar cadastros.
  • Tarifas BaaS — permissões para configurar as regras de tarifa dos clientes do BaaS, com as permissões Visualização, Configurar regras e Lançar tarifas.
  • Usuários BaaS — permissões para gerenciar as pessoas com acesso à conta master no BaaS, com as permissões Visualização e Gerenciar usuários.

Cada grupo apresenta as permissões que podem ser concedidas — Visualização, Acesso Total, Criação e Busca, conforme o grupo. Marque as permissões que o usuário deve ter e clique em Salvar para aplicar; Cancelar fecha a janela sem alterar as permissões.

Permissões do usuário

As permissões de um Titular da conta não podem ser alteradas: nesse caso o cargo aparece no topo da janela como Titular da conta, todas as caixas aparecem marcadas e inativas, o botão Salvar permanece desabilitado e a janela informa "Não é possível alterar as permissões de um titular da conta." No acesso do próprio usuário, a mensagem apresentada é "Não é possível alterar as próprias permissões."

Na medição de 19/10/2026, um usuário apresentado na listagem com o cargo TI abriu a janela também como Titular da conta, com todas as caixas marcadas e inativas e o Salvar desabilitado; um usuário com o cargo Signatário abriu a janela sem cargo no topo, com as caixas desmarcadas, editáveis e o Salvar habilitado.

A janela abre ao lado da listagem e fecha no ícone X ou em Cancelar.

Localizar um usuário​

Use o botão Avançado para abrir os filtros da lista: dois seletores, Filtro... e Operador..., o campo Valor.. e os botões de ícone +, que acrescenta a condição, e ×, que a exclui.

Os filtros permitem definir campo, operador e valor para localizar o usuário desejado.

Meus Limites​

A aba MEUS LIMITES é destinada exclusivamente à consulta dos limites vigentes da conta.

A tela abre como Limites da sua conta, com o subtítulo "Veja seus limites e janela horária vigente para sua conta."

Os limites não podem ser alterados nessa tela.

O sistema apresenta a janela horária da conta no cartão Período noturno: 20:00 → 06:00. Ao selecionar esse cartão, abre a janela Período noturno da conta — "Define os intervalos diurno e noturno usados pelos limites de Pix por janela." — com a linha do tempo do dia (Vigente, 00h, 06h, 12h, 18h e 24h) e as duas janelas: JANELA NOTURNA 20:00 — 06:00, com a orientação "Aplica os limites de Pix da janela noturna definidos abaixo.", e JANELA DIURNA 06:00 — 20:00, com "Complemento — usa os limites de Pix da janela diurna." A janela fecha no ícone X.

Detalhe do período noturno

A tela também exibe as políticas de limite vigentes da conta, cada uma em uma seção expansível. No exemplo observado, são apresentadas duas políticas:

  • Limites gerais da conta — "Esta política define o teto absoluto da conta, por débito e pelo valor agrupado dos débitos do período. Débitos operacionais excluídos do consumo: débito autorizado, taxa e IOF." Na conta observada, a política tem a dimensão Diário.
  • Envio de Pix — "Esta política define os limites aplicados ao envio de Pix pela conta." Na conta observada, a política tem as dimensões Diurno, Noturno, Diurno para favorecidos e Noturno para favorecidos.

Para cada dimensão, são apresentados o Limite vigente e, quando existir, uma Alteração pendente. Ao abrir a aba, a política Envio de Pix já vem expandida; as demais abrem no clique. As políticas e as dimensões exibidas variam conforme a configuração da conta.

Limites da conta

Políticas de limite da conta com as duas seções abertas

Adesões​

A aba ADESÕES reúne os produtos que dependem de adesão da conta junto à instituição. Os produtos são apresentados em cartões agrupados por serviço, com o nome do produto e a situação. No exemplo observado, em 30/09/2026, a seção Cobranças (Pix e boleto) apresentava os cartões Cobranças e DDA; nas medições de 28 e 29/09/2026, a aba também apresentava o cartão Emissão de boletos. Na medição de 01/10/2026, depois do aceite de Cobranças, a aba apresentava dois produtos — Cobranças (Pix e boleto) e DDA.

Quando o produto está liberado para a conta, o cartão apresenta a situação Liberado nesta conta. No exemplo observado, em 28/09/2026, os três produtos apareciam nesse estado. Na medição de 18/10/2026, a aba apresentava a seção Cobranças (Pix e boleto) com dois cartões, Cobranças e DDA, ambos em Liberado nesta conta.

Aba Adesões com os três produtos liberados para a conta

Aba Adesões em 01/10/2026, com os produtos Cobranças (Pix e boleto) e DDA liberados para a conta

Quando a adesão ainda não foi concedida, a situação é Indisponível e o cartão traz a orientação de solicitar a adesão à instituição — no estado observado em 30/09/2026, por exemplo, "A adesão a Cobranças pelo Finance não está disponível. Solicite a adesão à instituição."; na medição de 29/09/2026, o mesmo aviso aparecia para Cobranças e para Emissão de boletos.

O cartão também apresenta a situação Adesão pendente, quando o produto depende do aceite dos termos da instituição. O aceite é apresentado de duas formas, conforme o produto e o momento da tela.

Com o botão Ativar, que conclui o aceite em um clique: o cartão informa "Ao ativar, você está de acordo com os Termos de adesão." e traz o link Termos de adesão, que abre o documento em uma nova aba. No exemplo observado, em 30/09/2026, o cartão do DDA estava nesse estado, com a orientação "Ative a visualização dos boletos emitidos em seu CPF ou CNPJ", enquanto Cobranças aparecia como Indisponível.

Com a caixa de aceite na própria aba: o cartão traz a orientação do produto, o link Ler os termos e a caixa de aceite, e o botão Aceitar permanece inativo enquanto a caixa não é marcada. No estado observado em 01/10/2026, o cartão Boas-vindas a Cobranças apresentava a orientação "Para usar Cobranças, leia e aceite os termos da instituição. O aceite libera o produto nesta conta. A adesão vale para cobranças por Pix e por boleto.", o link Ler os termos e a caixa Li e aceito os termos de Cobranças (versão 2); na medição de 29/09/2026, esse estado era apresentado com a caixa Li e aceito os termos de DDA (versão 1).

Aba Adesões com Cobranças e Emissão de boletos indisponíveis e o DDA com adesão pendente, em 29/09/2026

Aba Adesões em 30/09/2026, com a seção Cobranças (Pix e boleto), o produto Cobranças Indisponível e o DDA em Adesão pendente com o botão Ativar

Aba Adesões em 01/10/2026, com o cartão Boas-vindas a Cobranças em Adesão pendente, a caixa de aceite e o DDA Liberado nesta conta

No exemplo observado, em 30/09/2026, o clique em Ativar concluiu a adesão do DDA sem etapa de confirmação e o cartão passou a apresentar a situação Liberado nesta conta.

Os produtos marcados como Indisponível têm a adesão solicitada junto à instituição. Quando a situação é Adesão pendente, a liberação acontece na própria aba, pelo aceite dos termos.