Bunne Docs

Papéis e permissões

Quem convidar para o painel: o que cada papel abre, o que ele altera e o que fica fora do alcance dele.

Cada pessoa convidada para o painel da Bunne recebe UM papel, e o papel decide o que ela abre e o que ela altera. A tabela abaixo é a mesma que aparece na tela Equipe do painel — e sai do código que de fato autoriza cada ação, não de uma redação à parte.

Decide significa alterar o que está ali: a ação é recusada no servidor para quem não pode, mesmo que alguém chegue à tela por link direto. Vê é leitura. Um papel que não aparece numa linha não enxerga aquela tela nem no menu.

O primeiro acesso de uma white label é sempre um Admin. Só o Admin convida, troca papéis e remove pessoas — e o painel impede que o último Admin seja removido ou rebaixado, para a conta nunca ficar sem dono.

Papéis da white label

Quem opera a plataforma: a sua equipe.

  • Admin — Dono da operação: dinheiro, adquirentes, chaves e equipe. Sem limite dentro do tenant.
  • Financeiro — Taxas, receita, conciliação e a fila de repasse — mas quem aprova a saída do dinheiro é o Admin.
  • Suporte — Atende o lojista: transações, chargebacks e a ficha do estabelecimento. Não mexe em dinheiro nem em configuração.
  • Desenvolvedor — Integra: chaves, webhooks, 3DS e sandbox. Não vê receita nem decide risco.
  • Compliance — Decide KYC, risco e antifraude. Não chega em adquirente, chave comum nem repasse.
Tela ou decisãoAdminFinanceiroSuporteDesenvolvedorCompliance
Operação
Visão geral
Números do dia, saúde da operação e o que falta configurar.
VêVêVêVêVê
Estabelecimentos
A ficha do lojista: dados cadastrais, contato e situação.
Quem ATENDE e quem ANALISA corrigem dado cadastral: o Suporte no atendimento (telefone errado, nome fantasia) e o Compliance na análise (razão social ou documento divergente do que ele está validando). Pedir para um terceiro corrigir o que você acabou de encontrar é o que fazia o cadastro envelhecer errado. A auditoria registra quem mudou. Ligar/desligar o lojista e trocar o domínio do checkout são decisões à parte, logo abaixo.
DecideVêDecide—Decide
Criar, ativar ou suspender um estabelecimento
Traz um lojista para a base, e liga ou desliga a operação dele.
Decisão de negócio, não de atendimento: fica fora do Suporte de propósito.
Decide————
Domínio do checkout do estabelecimento
Em qual domínio verificado os links de pagamento daquele lojista abrem.
Erro aqui manda o comprador para o endereço errado e derruba venda.
Decide————
KYC
Fila de análise documental: aprovar ou rejeitar com motivo.
É o papel do Compliance: decide KYC sem chegar perto de adquirentes, chaves ou dinheiro.
Decide———Decide
Transações
Todas as cobranças da base, com detalhe, linha do tempo e tentativas.
Todo mundo VÊ a transação; as decisões sobre ela (estorno, chargeback, agendada) estão separadas abaixo.
VêVêVêVêVê
Estornar uma cobrança
Devolver dinheiro ao comprador, total ou parcial, pelo detalhe da transação.
DecideDecide———
Chargebacks
Contestações em curso, prazos e envio de evidência à adquirente.
O Compliance vê porque contestação é sinal de fraude e alimenta a análise dele — era a lacuna mais estranha da matriz: o papel de risco não enxergava o evento de risco mais caro. O Suporte vê porque "meu cliente abriu disputa" chega pelo atendimento. Abrir e responder continua com quem gere dinheiro: abrir um chargeback bloqueia o saldo do lojista.
DecideDecideVê—Vê
Cancelar cobrança agendada
Apagar uma cobrança futura já combinada com o lojista.
DecideDecide———
Risco
Investigação de comprador e cartão suspeitos, antes de a cobrança virar perda.
Fora do Suporte: investigação de risco não é atendimento. O que ele precisa para responder o lojista — a venda barrada — está em Antifraude.
DecideDecide——Decide
Antifraude
O que foi barrado, as listas de bloqueio e liberação e as regras de velocity.
O Suporte vê SÓ o que foi barrado — é o que ele precisa para responder "por que minha venda não passou?". As listas e as regras de velocity não aparecem para ele: regra de velocity vale para a base inteira, e mexer nela não é atendimento.
DecideDecideVê—Decide
Links de pagamento
Criar e desativar links de cobrança avulsa.
DecideVê———
Conciliação
Confronto entre o que a adquirente reporta e o que o nosso ledger registrou.
Encerrar uma cobrança pendente de conferência é só do Admin.
DecideDecide———
Financeiro
Receita
Quanto a white label ganhou: taxa cobrada menos custo da adquirente.
VêVê———
Relatórios
Extrações para contabilidade e fechamento.
VêVê———
Recebíveis
Agenda do que cada lojista tem a receber e quando.
VêVê———
Tesouraria
Caixa da white label: entradas da adquirente e o que sustenta os repasses.
DecideVê———
Repasses
Dinheiro saindo para o lojista: fila, aprovação e comprovante.
Financeiro monta e acompanha a fila; quem APROVA a saída do dinheiro é o Admin.
DecideVê———
Antecipações
Adiantar recebível ao lojista e a taxa cobrada por isso.
Decide————
Cessões
Cessão de recebíveis a um FIDC ou fundo.
DecideVê———
Juros recebidos
O juro do parcelamento que volta pelo split, com total por período.
VêVê———
Taxas
Os planos de preço cobrados dos lojistas, e qual plano vale para quem.
Quem atende precisa responder "quanto eu pago?" sem pedir favor — por isso Suporte e Compliance LEEM. Mexer no plano DEFAULT muda o preço de toda a base de uma vez: isso é do Admin e do Financeiro.
DecideDecideVê—Vê
Taxa de UM estabelecimento
O preço negociado com um lojista específico, sem tocar no da base.
É a única fatia de preço que o Compliance move: o caso a caso, que costuma nascer da análise dele. O plano da base e o da carteira de um parceiro continuam fora — os dois reprecificam mais de um lojista de uma vez.
DecideDecideVê—Decide
Custo da adquirente
O que a adquirente cobra de nós — o outro lado da margem.
DecideVê———
Margem da white label
O juro do parcelado e o acréscimo do parceiro — o que a WL ganha por cima.
Sai de "Taxas" porque é a NOSSA margem, não o preço do lojista: quem atende não precisa dela, e ela não deve viajar numa conversa com cliente.
DecideDecide———
Infraestrutura
Adquirentes
Credenciais, capacidades e roteamento — por onde a cobrança sai.
Guarda credencial de produção. Ninguém além do Admin abre, nem em leitura.
Decide————
Provedores de repasse
Por onde o dinheiro sai para o lojista.
Decide————
Regras de split
Como cada venda se divide entre lojista, parceiro e plataforma.
DecideVê———
Logs de integração
O que foi enviado e respondido pela adquirente, para diagnóstico.
Vê————
Paridade do ledger
Checagem técnica de que o ledger fecha com os saldos.
VêVê———
Desenvolvedores
Chaves de API
Emitir, revogar e definir permissões das chaves de integração.
Decide——Decide—
Liberar bypass de 3DS / antifraude numa chave
Remover proteção antifraude ou 3DS de um token, e liberar cobrança agendada.
Mais estreito que emitir chave de propósito: o Desenvolvedor emite chave comum, mas não remove proteção. É decisão de risco.
Decide———Decide
Limites de requisição
Teto de chamadas por chave e por rota.
Decide——Vê—
3-D Secure
Quando exigir desafio do portador e com qual provedor.
Decide——Vê—
Webhooks
Destinos de notificação, segredo de assinatura e reenvio.
Decide——Decide—
Chaves de idempotência
Histórico de repetição de requisição, para depurar integração.
Vê——Vê—
Simular pagamento no sandbox
Fechar um Pix ou boleto de teste que nunca teria pagador.
É ferramenta de integração, não de dinheiro: por isso entra o Desenvolvedor e não o Financeiro. Só existe no ambiente de testes.
Decide——Decide—
Área de testes
Disparar chamadas reais da API pelo painel.
Decide————
Documentação
Referência da API com a marca e o domínio da white label.
Vê——Vê—
Administração
Auditoria
Quem fez o quê, quando e de onde — inclusive login e troca de senha.
Vê————
Conta e equipe
Minha conta
Nome, e-mail de acesso, senha e sessões ativas da própria pessoa.
Sem guard de papel de propósito: o dado é da pessoa, não do tenant.
DecideDecideDecideDecideDecide
Equipe
Convidar, trocar papel e remover gente — esta tela.
Decide————
Personalização
Marca, cores e domínio próprio do checkout e do painel.
Decide————
Configurações
Antecipação, chargeback, moedas e canais de reserva do tenant.
O conteúdo é financeiro (spread, antecipação, retenção), então o Financeiro lê; alterar é do Admin.
DecideVê———

Papéis do estabelecimento

A equipe de cada lojista da sua base, no painel dele. Quem convida ali é o Admin do próprio estabelecimento.

  • Admin — Dono do estabelecimento: estorno, KYC, equipe e configuração.
  • Financeiro — Saldo, recebíveis, antecipação e chargebacks. Não estorna.
  • Suporte — Só consulta transações para atender o comprador.
  • Desenvolvedor — Chaves, webhooks e documentação. Não vê venda nem dinheiro.
Tela ou decisãoAdminFinanceiroSuporteDesenvolvedor
Operação
Visão geral
Vendas do dia, saldo e pendências do estabelecimento.
VêVêVêVê
Transações
As cobranças do estabelecimento, com detalhe e linha do tempo.
O Desenvolvedor NÃO vê transação: a integração se depura por logs e webhooks, não por dado de venda.
VêVêVê—
Estornar uma cobrança
Devolver dinheiro ao comprador pelo detalhe da transação.
Só o Admin do estabelecimento. O Financeiro acompanha a venda, mas não desfaz.
Decide———
Chargebacks
Contestações recebidas, prazo de resposta e envio de evidência.
DecideDecide——
Links de pagamento
Criar e desativar links de cobrança avulsa.
DecideVê——
Financeiro
Saldo
Disponível, a liberar e o que está retido.
VêVê——
Recebíveis
Agenda de liberação, parcela a parcela.
VêVê——
Antecipação
Pedir o recebível antes do prazo e ver a taxa cobrada.
DecideDecide——
Relatórios
Extrações para conciliação e contabilidade.
VêVê——
Recebido por split
De onde veio o dinheiro que entrou por divisão de venda.
VêVê——
Regras de split
Como as vendas se dividem com os parceiros do lojista.
DecideVê——
Taxas
As taxas que a white label cobra deste estabelecimento.
Leitura para os dois: quem define o preço é a white label.
VêVê——
Desenvolvedores
Chaves de API
Emitir e revogar as chaves que o checkout do lojista usa.
Emitir exige KYC aprovado pela white label. Revogar segue liberado sempre — é redução de exposição.
Decide——Decide
Webhooks
Destinos de notificação e reenvio de evento.
Decide——Decide
Documentação
Referência da API com a marca da white label.
Vê——Vê
Conta e equipe
Minha conta
Nome, e-mail de acesso, senha e sessões ativas da própria pessoa.
DecideDecideDecideDecide
KYC
Enviar documentos e dados para a white label liberar a operação.
Decide———
Equipe
Convidar, trocar papel e remover gente do estabelecimento.
Decide———
Auditoria
Quem fez o quê na conta do estabelecimento.
Vê———
Configurações
Nome fantasia e preferências do estabelecimento.
Razão social, CNPJ e dados de KYC só a white label altera.
Decide———

Escolhendo um papel

A regra prática: dê o papel mais estreito que resolve o trabalho da pessoa. Três separações existem de propósito e não devem ser contornadas promovendo alguém a Admin — Compliance decide KYC, risco e antifraude sem tocar em adquirente nem em repasse; Financeiro monta a fila de repasse mas não aprova a saída do dinheiro; Desenvolvedor emite chave e configura webhook sem ver receita.

Papel é por pessoa e por conta: a mesma pessoa pode ser Admin numa white label e Financeiro noutra, com um login só. Trocar o papel de alguém vale na navegação seguinte.