Funções de usuário

Cada pessoa que você convida para uma organização recebe uma função. É ela que decide o que a pessoa enxerga e o que pode alterar no Dashboard — de “só olhar” até “controle total”. São quatro funções prontas e, quando nenhuma encaixa, você monta a sua no próprio convite.

​

As quatro funções

​

O que cada função vê e edita

Cada função libera um conjunto de acessos por área do produto — o que a pessoa pode ver e o que pode editar:

Matriz técnica de permissões (para APIs e integrações)

Internamente, cada ação é amarrada a uma capability (uma chave curta como refund.create). A função define quais capabilities a pessoa tem. Esta é a matriz completa:

Capability	Admin	Dev	Suporte	Viewer
org.delete — excluir a organização	✅	—	—	—
org.manage — configurações da organização	✅	—	—	—
user.manage — convidar, remover, trocar função	✅	—	—	—
api_key.manage — criar e revogar API keys	✅	✅	—	—
api_key.read_secret — visualizar o token cru	✅	✅	—	—
webhook.manage — endpoints de webhook	✅	✅	—	—
dev_tools.view — DevConsole, logs de eventos	✅	✅	—	—
payment_profile.manage — KYC, contas para saques, splits	✅	—	—	—
payout_account.read — visualizar conta para saques	✅	—	—	—
product.write — criar/editar produtos e preços	✅	—	—	—
discount.write — criar/editar descontos e cupons	✅	—	—	—
payment.create — checkout sessions, payment intents, payment links	✅	—	✅	—
customer.write — criar/editar customers	✅	—	✅	—
subscription.write — criar/atualizar/cancelar/pausar	✅	—	✅	—
refund.create — emitir reembolsos	✅	—	✅	—
dispute.respond — anexar e editar evidência, enviar a defesa e encerrar disputas	✅	—	✅	—
business.read — ler customers, charges, subs, invoices, refunds, disputes, payments	✅	✅	✅	✅

​

Funções personalizadas

Quando nenhuma das quatro encaixa, monte a sua na hora de convidar: em Configurações → Equipe → Adicionar usuário, marque e desmarque os acessos direto na tabela de permissões. O seletor passa a mostrar Personalizado e aparece um campo para nomear a função — por exemplo, “Gestor de marketing”. O convite só é enviado depois que ela tem nome. A função criada entra no catálogo da organização: passa a aparecer no seletor dos próximos convites e no menu Mudar para… de quem já está na equipe. Nomes não se repetem — reutilizar o mesmo nome com outras permissões é recusado, para nunca alterar em silêncio o acesso de quem já tem aquela função.

​

Gerenciar a equipe

A tela fica em Configurações → Equipe. Só quem é Administrador vê os controles — convidar, trocar função e remover. Ao escolher uma função no convite, o Dashboard já mostra o que aquela pessoa vai poder ver e editar: Como funciona:

• Convidar. Clique em Adicionar usuário, informe o e-mail e escolha a função. A pessoa recebe um convite por e-mail e entra com esse mesmo endereço.
• Trocar a função. No menu … ao lado da pessoa, escolha Mudar para…. Vale na hora.
• Remover. No mesmo menu, Revogar acesso. A pessoa perde o acesso na hora.

Um administrador pode conceder qualquer função, inclusive Administrador. Você pode sair da organização quando quiser (a menos que seja o último administrador), mas não muda a própria função.

​

Acesso herdado de plataformas

Se a sua organização é uma plataforma com organizações conectadas, a função na equipe da plataforma (Configurações da plataforma → Equipe, no console da plataforma) vale também nas conectadas: um administrador da plataforma age como administrador em cada uma delas, um desenvolvedor vê as ferramentas de desenvolvimento de cada uma, e assim por diante. Quando a pessoa tem um acesso direto na organização conectada e outro herdado da plataforma, os dois se somam — ela pode tudo que qualquer um dos acessos permite. Ninguém perde um acesso que recebeu de propósito.

​

A segurança é garantida no servidor

Esconder um botão nunca é a única proteção. Toda ação é verificada de novo no servidor antes de acontecer: se a função da pessoa não permite, a operação é recusada — mesmo que alguém tente por fora do Dashboard. O que você vê na tela (botões escondidos ou desativados) é só uma conveniência; a decisão final é sempre do servidor.

​

Função ≠ chave de API

São dois controles independentes: Uma pessoa com a função Suporte pode criar uma cobrança pelo Dashboard; o seu servidor pode fazer o mesmo com uma chave de escopo write. São caminhos paralelos para o mesmo recurso.

​

Próximos passos

• Crie uma equipe — o passo a passo de convidar e organizar sua equipe.
• Chaves de API — escopos, ambientes (live / test) e rotação.