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

# Funções e permissões do usuário

Como estruturar o acesso ao Business Portal e às APIs do Localpayment. Funções integradas, funções personalizadas e um modelo de privilégio mínimo recomendado para operações de pagamento.

Utilize o controle de acesso baseado em funções para conceder o nível de acesso adequado aos membros da equipe no Business Portal da Localpayment e nas APIs operacionais. O Business Portal oferece um conjunto de perfis de função integrados que você pode atribuir diretamente, e você também pode definir suas próprias funções personalizadas com permissões granulares.

## Funções disponíveis

> [accordion] GERENTE DE CONTAS
>
> &#x20;É possível configurar a conta comercial e ter acesso aos relatórios, saldo e portal da empresa.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Ver saldo.
> * Configurações:
>   * Visualizar e editar clientes
>     * Visualizar e editar usuários
>   * Ver Mestres
>     * Ver países
>     * Ver moedas
>     * Ver bancos
>     * Visualizar códigos de conceito
>     * Ver feriados
>     * Visualizar tipos de documentos
> * Business Portal:
>   * Ver clientes.
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.

> [accordion] ADMIN
>
> &#x20; Pode criar e autorizar (se aplicável) Payouts, Payins, reembolsos, estornos, Virtual Accounts, câmbio, transferências internas e liquidações; além de ter acesso a relatórios, saldo e portal da empresa.
>
> **Detalhes:**
>
> * API ativada.
> * Ver saldo.
> * Configurações:
>   * Visualizar e editar clientes
>     * Visualizar e editar usuários
>     * Gerenciamento
>       * Ver informações
>       * Ver configurações da conta
>       * Visualizar e editar dados bancários
>       * Ver e editar contatos
>       * Visualizar e editar funções
>       * Visualizar e editar usuários
>       * Visualizar e editar a lista de IPs permitidos
>       * Ver Comerciantes
>       * Ver e editar notificações
>       * Ver Acordos
>       * Visualizar e editar BINS
>   * Ver Mestres
>     * Ver países
>     * Ver moedas
>     * Ver bancos
>     * Visualizar códigos de conceito
>     * Ver feriados
>     * Visualizar tipos de documentos
> * Business Portal:
>   * Ver clientes.
> * Payins
>   * Visualizar, criar e autorizar Manual Payins
>   * Visualizar e criar Virtual Accounts
>   * Visualizar e executar estornos
>   * Visualizar, criar e autorizar reembolsos
>     * Veja o comprovante de pagamento (POP)
>   * Checkout
>     * Visualize o checkout online e execute o modelo
>     * Ver link de pagamento
>     * Ver itens
>     * Visualizar Iframe
>     * Visualize e execute as chaves da API Smart Fields
>     * Ver aparência
> * Payouts
>   * Visualizar, criar e autorizar Manual Payouts
>   * Veja o comprovante de pagamento (POP)
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.
>   * Exportar relatórios
> * Liquidação e Câmbio
>   * Visualizar, criar e editar Transferência interna
>   * Visualizar e criar câmbio de moedas
>   * Visualize, crie e edite Wire in
>   * Visualize, crie e edite Wire out

> [accordion] USUÁRIO DA API
>
> &#x20;Possui acesso total às APIs do Localpayment.
>
> &#x20;Este usuário não pode usar o Business Portal Localpayment.
>
> **Detalhes:**
>
> * API ativada.

> [accordion] AUTORIZAÇÃO NÍVEL 1
>
> &#x20;Pode autorizar Payouts, reembolsos e liquidações; criar conversões de moeda e transferências internas; e tem acesso a relatórios, saldo e ao portal da empresa.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Ver saldo.
> * Business Portal:
>   * Ver clientes.
> * Payins
>   * Visualizar e autorizar reembolsos
>     * Veja o comprovante de pagamento (POP)
> * Payouts
>   * Visualizar e autorizar Manual Payouts
>   * Veja o comprovante de pagamento (POP)
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.
> * Liquidação e Câmbio
>   * Visualizar, criar e editar Transferência interna
>   * Visualizar e criar câmbio de moedas
>   * Visualizar e editar Wire in
>   * Visualizar e editar Wire Out

> [accordion] AUTORIZAÇÃO NÍVEL 2
>
> &#x20;Pode autorizar Payouts, reembolsos e liquidações; criar transferências internas; e tem acesso a relatórios, saldo e ao portal da empresa.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Ver saldo.
> * Business Portal:
>   * Ver clientes.
> * Payins
>   * Visualizar e autorizar reembolsos
>     * Veja o comprovante de pagamento (POP)
> * Payouts
>   * Visualizar e autorizar Manual Payouts
>   * Veja o comprovante de pagamento (POP)
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.
> * Liquidação e Câmbio
>   * Visualizar e criar transferência interna
>   * Visualizar e editar Wire in
>   * Visualizar e editar Wire Out

> [accordion] OPERATIONS CHARGEBACK LEVEL 1
>
> &#x20;Pode criar contestações de pagamento e tem acesso a relatórios, saldo e portal da empresa.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Ver saldo.
> * Business Portal:
>   * Ver clientes.
> * Payins
>   * Visualizar e executar estornos
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.

> [accordion] OPERATIONS CHARGEBACK LEVEL 2
>
> &#x20;Pode criar contestações de pagamento e tem acesso a relatórios, saldo e portal da empresa.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Ver saldo.
> * Business Portal:
>   * Ver clientes.
> * Payins
>   * Visualizar e executar estornos
>   * Visualizar e criar reembolsos
>     * Veja o comprovante de pagamento (POP)
> * Payouts
>   * Visualizar e criar Manual Payouts
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.
> * Liquidação e Câmbio
>   * Visualizar e criar transferência interna
>   * Visualizar e criar câmbio de moedas
>   * Visualize e crie Wire out

> [accordion] NÍVEL DE OPERAÇÕES 1
>
> &#x20;É possível criar Payouts, Payins, reembolsos e liquidações, além de ter acesso a relatórios, saldo e portal da empresa.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Ver saldo.
> * Business Portal:
>   * Ver clientes.
> * Payins
>   * Visualizar e criar reembolsos
> * Payouts
>   * Visualizar e criar Manual Payouts
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.
> * Liquidação e Câmbio
>   * Visualize e crie Wire out

> [accordion] NÍVEL DE OPERAÇÕES 2
>
> &#x20;É possível criar Payouts, Payins, reembolsos, estornos, Virtual Accounts, transferências internas e liquidações; além de ter acesso a relatórios, saldo e portal da empresa.
>
> **Detalhes:**
>
> * API ativada.
> * Ver saldo.
> * Business Portal:
>   * Ver clientes.
> * Payins
>   * Visualizar e criar Virtual Accounts
>   * Visualizar e executar estornos
>   * Visualizar e criar reembolsos
>     * Veja o comprovante de pagamento (POP)
> * Payouts
>   * Visualizar e criar Manual Payouts
>   * Veja o comprovante de pagamento (POP)
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.
> * Liquidação e Câmbio
>   * Visualizar e criar transferência interna
>   * Visualize e crie Wire in
>   * Visualize e crie Wire out

> [accordion] NÍVEL DE RECONCILIAÇÃO 1
>
> &#x20;Tem acesso a relatórios de atividades e assinaturas.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver Assinaturas.

> [accordion] NÍVEL DE RECONCILIAÇÃO 2
>
> &#x20;Tem acesso a relatórios, saldo e Business Portal.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Ver saldo.
> * Business Portal:
>   * Ver clientes.
> * Payins
>   * Reembolsos
>     * Veja o comprovante de pagamento (POP)
> * Payouts
>   * Veja o comprovante de pagamento (POP)
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.

> [accordion] TESOURARIA
>
> &#x20;Permite realizar câmbio de moedas, transferências internas e liquidações, além de ter acesso a relatórios, saldo e Business Portal.
>
> &#x20;Este usuário não pode usar a API Localpayment.
>
> **Detalhes:**
>
> * Ver saldo.
> * Business Portal:
>   * Ver clientes.
> * Relatórios:
>   * Clientes
>     * Ver atividade
>     * Ver saldo
>     * Ver Fides
>     * Ver Assinaturas.
> * Liquidação e câmbio:
>   * Visualizar e criar transferência interna
>   * Visualizar e criar câmbio de moedas
>   * Visualize e crie Wire out

***

## Criando funções personalizadas

Se as funções integradas acima não corresponderem à forma como você deseja segmentar o acesso, você pode criar suas próprias funções personalizadas e atribuir permissões granulares por módulo.

### Pré-requisitos

Antes de começar, certifique-se de ter:

**Requisitos de acesso**

* Credenciais válidas para o [Business Portal Localpayment](https://ui.v3.localpayment.com/login)
* Conta de usuário com [permissões de configurações de segurança](https://docs.localpayment.com/pt-br/docs/user-roles-and-permissions.md)

***

### Caminho de navegação

```
Side Menu → Configurations → Client → Edit → Roles
```

***

### Guia passo a passo

1. Acesse o módulo **Configurações**.
2. Em Configurações, selecione a seção **Clientes**.
3. Clique na opção **Editar** para abrir as configurações da sua conta.
4. Nas configurações da sua conta, localize e selecione a guia **Funções**.
5. Clique no botão **ADICIONAR FUNÇÃO**.
6. No formulário que aparecer, preencha as informações sobre a função:
   * **Tipo**: Este campo é fixo como **Externo** e não pode ser alterado.
   * **Nome** : Insira um nome exclusivo para a função.
   * **Descrição** : Forneça uma descrição para a nova função.
   * **Permissões** :  Selecione pelo menos uma permissão. Passe o cursor sobre qualquer permissão para ver uma dica com mais detalhes.
7. Clique em **Salvar**. A nova função estará agora disponível para ser atribuída aos seus usuários.

Acesse o módulo **Configurações**.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/e0b31e6797aead93d5f3d643acea2d370f242310b5d15c244d018a0149694733-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=702d9cce60ed4a61538a74a7b055ff28)

Em Configurações, selecione a seção **Clientes**.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/dcbec917bfb334d8d72674be038956c53bd79126c7b4116c1d3f83f7800e2bff-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=562df275f6933883832b321f01afefce)

Clique na opção **Editar** para abrir as configurações da sua conta.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/027aec6709a8f0aac50c7e16fa033d93b4edb231017628644905e8a9f8576309-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=349fe1926b9b871500710d0377d43ce4)

Nas configurações da sua conta, localize e selecione a guia **Funções**.

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/575919e6b0977b073d220c3fb77fe95ebf90f5d9ad4aaddeab1583b19797b97c-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=75c226e7ee472fff5d8c9ae880909451)

Clique no botão **ADICIONAR FUNÇÃO**.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/aa8814a04623cee1d5d7fa4b53b69a11fef40ec16367b56d729491adcf1ba5e3-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=cce1cdcca6bb39293bb2906d597892c6)

No formulário que aparecer, preencha as informações sobre a função.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/986777d35fa69ce31a334e6fa780af3356c16795ed5786c01bba6d5e9e3fde5d-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=1075db5a04a89eb21937f8a895261a50)

Clique em **Salvar**. A nova função estará agora disponível para ser atribuída aos seus usuários.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/dde76b9ca583933b3543075279b6953e275970f870935437f5c30ced20e188f6-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=ea86fa5522660bfabf748b77b27c6ce7)

***

### Lista de permissões

Defina as permissões disponíveis que podem ser atribuídas a uma função personalizada. Cada permissão determina o nível de acesso e as ações que um usuário pode executar em módulos específicos do **Painel Localpayment**.

* **API**: Concede acesso às credenciais da API, à configuração e às ferramentas de integração.
* **Saldos**: Permite visualizar e monitorar os saldos da conta em diferentes moedas.
* **Business Portal**: Fornece acesso à visão geral principal com indicadores-chave de desempenho e atividades recentes.
* **Payin**: Permite o gerenciamento de pagamentos recebidos, incluindo a visualização de detalhes da transação e o início de reembolsos.
* **Payout**:  Concede controle sobre os pagamentos de saída, permitindo que os usuários iniciem e gerenciem transferências de fundos.
* **Relatórios**: Permite o acesso para gerar, visualizar e baixar relatórios financeiros e operacionais. Inclui as seguintes subpermissões:
  * **Clientes**: Acesso a relatórios por cliente, incluindo atividades, saldo, Fides e assinaturas.
  * **Histórico**: Acesso a relatórios históricos de transações e movimentações.
  * **Exportar**: Permite exportar dados de relatório para um arquivo. Esta subpermissão está disponível apenas para usuários com a função **ADMIN** integrada ou funções personalizadas onde ela foi explicitamente concedida.
* **Liquidação - Câmbio**: Permite visualizar e gerenciar detalhes de liquidação e operações de câmbio.
* **Configurações**: Fornece acesso às configurações gerais da plataforma, perfis de comerciantes e outras configurações globais.

***

### Gerenciando suas funções

#### Modificar função existente

1. Clique no ícone **Editar função** para a função desejada
2. Atualize o nome, a descrição e as permissões da função conforme necessário.
3. Clique em **Salvar** para aplicar as alterações.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/00fbe443750b3c1ee72112607beacf5a098d7711d8f1a7675b50bc2c5495848f-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=d8fc236bd9eab04c2aa1814746720e04)

#### Remover função

1. Clique no ícone **Excluir função** ao lado da função desejada.
2. Confirme a ação clicando em **Sim**.

> [!WARNING]
>
> **Importante**
>
> Antes de excluir uma função, certifique-se de que ela não esteja atribuída a nenhum usuário ativo para evitar problemas de acesso.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/db8c51300c1a7a5eb26878648335f2cbbc4c072db807fa4f225c34c77c4af23a-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=5f95615439b03d62173c7ebba90552f1)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.