> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# Usuários e Permissões

export const CheckIcon = ({mode, type, id}) => {
  const colorIcons = {
    'error': '#919191',
    'success': '#00AE42',
    'noSupported': '#919191'
  };
  const foundColor = colorIcons[mode];
  const iconType = mode === 'noSupported' ? type : `circle-${type}`;
  return <div className="check-icon" id={id}>
      <Icon icon={iconType} iconType="regular" color={foundColor} size={18} />
    </div>;
};

O [**Dashboard Malga**](https://dashboard.malga.io/), conta com diferentes perfis de acesso, permitindo que o proprietário e os administradores configurem as permissões dos usuários da empresa — definindo o que cada pessoa pode visualizar e realizar na plataforma.

No quadro abaixo, descrevemos os perfis disponíveis e respectivas características:

| Perfil de acesso          | Descrição                                                                                                                                                        |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Proprietário**          | Acesso total à plataforma. Reúne todas as permissões do Administrador e pode editar ou excluir outros Administradores.                                           |
| **Administrador**         | Acesso completo à operação, com todas as permissões da plataforma, exceto excluir o Proprietário e outros Administradores.                                       |
| **Operador**              | Executa operações de vendas (cobranças, clientes, links de pagamento e assinaturas) e gerencia recebedores, sem acesso a dados estratégicos da conta.            |
| **Analista**              | Visualiza operações de vendas (cobranças, clientes, links de pagamento e assinaturas), sem acesso a dados estratégicos da conta.                                 |
| **Analista de cobranças** | Visualiza apenas o menu de cobranças e os detalhes de transações, sem acesso aos demais menus e sem permissão para executar operações.                           |
| **Analista de subconta**  | Visualiza todos os dados da subconta vinculada ao produto white label e pode convidar usuários com a mesma permissão, mas sem permissão para executar operações. |
| **Desenvolvedor**         | Executa operações apenas no ambiente sandbox, sem acesso ao ambiente produção.                                                                                   |

<Tip>
  O Administrador pode gerenciar usuários e convidar novos usuários, exceto editar ou remover outros administradores. Essa ação é exclusiva do **Proprietário**, perfil único por empresa.

  Se sua empresa ainda não possui um perfil com o papel de **Proprietário**. Para configurar esse acesso, entre em contato com o nosso time de atendimento através do e-mail [suporte@malga.io](mailto:suporte@malga.io).
</Tip>

Abaixo detalhamos as permissões de cada perfil de usuário nos menus do Dashboard:

| Menu                    | Funcionalidade                                              |                Proprietário               |               Administrador               |                  Operador                 |                  Analista                 |           Analista de cobranças           | Analista de subconta                      |
| ----------------------- | ----------------------------------------------------------- | :---------------------------------------: | :---------------------------------------: | :---------------------------------------: | :---------------------------------------: | :---------------------------------------: | ----------------------------------------- |
| **Fluxos inteligentes** | Visualizar o fluxo de pagamentos por método e subconta      | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Publicar alterações no fluxo de pagamentos                  | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Acessar ao histórico de versões do fluxo de pagamentos      | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Restaurar uma versão anterior do fluxo de pagamentos        | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
| **Painel de Dados**     | Visualizar métricas de performance da loja                  | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
| **Cobranças**           | Acessar histórico da transação                              | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |
|                         | Filtrar e buscar cobranças                                  | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |
|                         | Copiar payload da cobrança                                  | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |
|                         | Exportar relatórios em .csv                                 | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Cancelar cobrança                                           | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Realizar estorno e captura total ou parcial da cobrança     | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
| **Clientes**            | Visualizar a listagem e detalhes de customers               | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Filtrar um cliente pelo ID (customer\_id)                   | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Realizar a exclusão de um customer                          | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
| **Cartões**             | Visualizar a listagem e detalhes de cartões cadastrados     | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
| **Links de pagamento**  | Visualizar listagem, URL e detalhes de um link de pagamento | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Filtrar e buscar links de pagamento                         | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Acessar detalhes da cobrança vinculada ao link              | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Criar link de pagamento                                     | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Alterar o status de um link para ativo ou inativo           | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Cancelar link de pagamento                                  | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
| **Subcontas**           | Visualizar a listagem e detalhe das subcontas               | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Ver métodos e IDs de contas nos provedores                  | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Renomear subconta                                           | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
| **Recebedores**         | Visualizar a listagem de recebedores cadastrados            | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Filtrar e buscar recebedores                                | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
| **Usuários**            | Visualizar a listagem de usuários cadastrados na empresa    | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Editar o nome de um usuário                                 | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="check" mode="success" /> |
|                         | Editar o papel de um usuário                                | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Excluir usuário da empresa                                  | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Editar ou excluir um usuário administrador                  | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
| **Assinaturas**         | Visualizar listagem e detalhes de assinaturas               | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Pausar uma assinatura                                       | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Retomar uma assinatura                                      | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |
|                         | Cancelar uma assinatura                                     | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |  <CheckIcon type="xmark" mode="error" />  |  <CheckIcon type="xmark" mode="error" />  | <CheckIcon type="xmark" mode="error" />   |

### Convidando um novo usuário

Para convidar um usuário a fazer parte da sua organização é simples, basta preencher o formulário presente na aba de usuários, ao clicar no botão **"Convidar usuário"**. Após, inserir o e-mail do convidado, nome (opcional) e indicar qual será o seu papel de acesso.

<Frame>
  <img alt="Convida usuário" lightAlt="Convida usuário" darkAlt="Convida usuário" src="https://mintcdn.com/malga/cA-KNcYFhalU08oc/assets/images/dashboard/users/invite-light.gif?s=ce6aa43fabd8fd1e2e33eb28b7af191b" className="dark:hidden" width="2720" height="1478" data-path="assets/images/dashboard/users/invite-light.gif" />

  <img alt="Convida usuário" lightAlt="Convida usuário" darkAlt="Convida usuário" src="https://mintcdn.com/malga/cA-KNcYFhalU08oc/assets/images/dashboard/users/invite-dark.gif?s=cebb5f28e08ac8f656d2ec91d676efad" className="hidden dark:block" width="2720" height="1478" data-path="assets/images/dashboard/users/invite-dark.gif" />
</Frame>

Administradores também conseguem apagar ou reenviar um convite. Na listagem de usuários, ao passar o mouse por cima de cada linha, você verá essas ações, mas também conseguirá realizá-las nos detalhes de um convite específico.

### Excluindo, reenviando ou editando um convite

Para apagar, editar ou reenviar um convite, basta passar o mouse sobre a linha do usuário na listagem — as ações disponíveis aparecerão. Você também pode realizar essas ações acessando os detalhes do convite específico.

<Frame>
  <img alt="Ações na listagem de usuários" lightAlt="Ações na listagem de usuários" darkAlt="Ações na listagem de usuários" src="https://mintcdn.com/malga/cA-KNcYFhalU08oc/assets/images/dashboard/users/actions-menu-users-light.gif?s=32c9e6e155373633c581dd1327d973eb" className="dark:hidden" width="2866" height="1482" data-path="assets/images/dashboard/users/actions-menu-users-light.gif" />

  <img alt="Ações na listagem de usuários" lightAlt="Ações na listagem de usuários" darkAlt="Ações na listagem de usuários" src="https://mintcdn.com/malga/cA-KNcYFhalU08oc/assets/images/dashboard/users/actions-menu-users-dark.gif?s=7c56ec09b193bc7994bb05869e0f698d" className="hidden dark:block" width="2866" height="1482" data-path="assets/images/dashboard/users/actions-menu-users-dark.gif" />
</Frame>

### Reativar usuários

Por segurança, usuários que ficarem mais de 90 dias sem acessar o Dashboard serão desativados automaticamente. Apenas o **Proprietário** da conta poderá reativá-los.

<Info>
  Se precisar de ajuda na edição dos usuários da sua empresa, acione o nosso time de atendimento através do e-mail [suporte@malga.io](mailto:suporte@malga.io);
</Info>


## Related topics

- [Sep 10 - Usuários e permissões](/release-notes/2024-09-10-Release-Notes.md)
- [Realizar nova cobrança](/api-reference/charges/realizar-nova-cobranca.md)
- [May 2025 - Convite de Usuários](/release-notes/2025-05-07-Release-Notes.md)
- [Gestão de Cobranças](/documentations/dashboard/charge-details.md)