Gerenciar clientes como parceiro

A área Parceiro (/partner) aparece para os membros da organização parceira. O Owner e os Admin do parceiro gerenciam vínculos, equipe, transferências, perfil e cobrança; os demais membros veem só os clientes a que foram atribuídos.

Vínculos

Um vínculo liga o parceiro a uma organização cliente. Ele nasce de três jeitos:

• o parceiro convida o cliente pelo slug da organização, propondo um teto (Viewer, Developer ou Admin, nunca Owner), os projetos (todos ou uma lista) e a forma de cobrança;
• o cliente oferece o vínculo a um parceiro do diretório, e o Owner ou um Admin do parceiro aceita;
• uma organização criada com o link de indicação do parceiro recebe o convite automaticamente.

O convite vale 14 dias. O Owner do cliente aceita (com confirmação do segundo fator), pode baixar o teto e restringir os projetos, e pode recusar. Só existe um vínculo aberto por parceiro e cliente.

Equipe e atribuições

Em Clientes › vínculo › Equipe, atribua membros da organização parceira ao cliente com um papel até o teto. O acesso efetivo é o menor entre o papel da atribuição e o teto:

• com todos os projetos, a pessoa recebe esse papel na organização cliente;
• com projetos selecionados, recebe Member na organização e o papel em cada projeto permitido.

Não é possível atribuir quem já é membro direto do cliente nem contas de serviço. Quem sai da organização parceira perde o acesso a todos os clientes na mesma hora. As mudanças de teto, projetos e atribuições valem na próxima requisição.

Ao entrar na organização do cliente, o portal mostra a faixa "Você está acessando <cliente> como parceiro <parceiro>", e a lista de organizações marca as que você acessa pelo parceiro.

MFA é obrigatório

Todo acesso delegado exige segundo fator, qualquer que seja a política do cliente: sessão com MFA (TOTP ou passkey) e, para a CLI, token pessoal criado em sessão com MFA. Sem fator cadastrado, a organização do cliente responde "cadastre um segundo fator para continuar". Veja Segurança da conta.

O que o acesso delegado não faz

Pelo vínculo, a equipe opera aplicações, deploys, dados e configuração do cliente, mas nunca:

• cobrança, meios de pagamento, créditos, tetos de gasto e custos do cliente;
• transferência de propriedade, desativação ou exclusão da organização;
• membros, convites, times e as concessões de acesso dos projetos;
• contas de serviço (elas sobreviveriam à revogação), SSO, política de MFA e política MCP;
• o próprio acesso de parceiros e os pedidos de titular de dados.

Essas rotas respondem "Esta ação não está disponível pelo acesso de parceiro". Tudo o que a equipe faz aparece na auditoria do cliente como via <parceiro>, e ações destrutivas (exclusão de aplicação, banco, volume ou domínio, rotação de credencial) geram uma notificação ao Owner do cliente.

Organizações criadas para o cliente

Em Transferências › Nova organização, o parceiro cria a organização do cliente informando o nome, o slug, o e-mail do cliente, o teto depois da transferência e a forma de cobrança. Quem criou fica como Owner temporário, e o cliente recebe um e-mail com o link de aceite (quem ainda não tem conta cria com o mesmo e-mail).

Ao aceitar (com confirmação do segundo fator), o cliente vira Owner, as memberships diretas da equipe do parceiro saem e o vínculo nasce ativo com atribuições equivalentes. Enquanto a transferência não é aceita, a cobrança é do parceiro. Depois de 30 dias a pendência aparece no painel do parceiro e no relatório da plataforma, e o parceiro pode reenviar o convite. Os Termos do Programa exigem a transferência.

Visão consolidada

O Painel lista os clientes com o estado do vínculo, o plano, restrições, pendência de propriedade e um resumo de saúde atualizado a cada 5 minutos: aplicações e bancos com falha, deploys com falha em 24 horas, alertas disparados e achados críticos, sempre filtrados pelos projetos do vínculo. O custo do mês e a projeção aparecem só para Owner/Admin do parceiro e só quando a cobrança é consolidada ou o cliente compartilha os custos.

Cobrança e extrato

Formas de cobrança

Cada vínculo tem uma forma de cobrança:

Forma	Quem paga	O parceiro recebe
Direta (padrão)	O próprio cliente	Comissão sobre as faturas pagas
Consolidada	O parceiro, num extrato mensal	Desconto do nível sobre o extrato

O parceiro propõe e o cliente aceita; o cliente pode voltar sozinho para a direta. A mudança vale a partir do próximo período: a forma vigente no início do período decide quem paga aquele período inteiro. Um cliente tem no máximo um vínculo consolidado.

Extrato consolidado

No fechamento do mês, as faturas dos clientes consolidados continuam existindo (uma por organização) e são agrupadas no extrato do parceiro, com o desconto do nível. O extrato é cobrado no meio de pagamento da organização parceira; quando é pago, todas as faturas dele ficam pagas. Créditos do cliente não abatem faturas pagas pelo parceiro; créditos da organização parceira abatem o extrato.

Se o extrato atrasa, o parceiro fica bloqueado para novos vínculos e transferências; perto do prazo, os clientes ainda consolidados recebem um aviso com a data-limite e podem mudar para a cobrança direta; no fim do prazo, os que continuam consolidados e a organização parceira têm os deploys restringidos (o tráfego nunca é cortado).

Extrato do parceiro (ledger)

O ledger registra comissões, estornos (reembolso de uma fatura estorna a comissão proporcional), recompensas de indicação, conversões e repasses, com o saldo após cada lançamento. Ações disponíveis para o Owner do parceiro:

• Converter em créditos: transforma saldo em créditos da organização parceira (validade de 365 dias), com confirmação do segundo fator.
• Repasse em dinheiro: registrado pela plataforma com a referência da transferência.
• Exportar CSV do ledger e dos extratos.

O tratamento fiscal da comissão e da cobrança consolidada ainda depende de respostas do contador; enquanto isso a cobrança consolidada pode estar indisponível.

Indicação

Em Indicações, o parceiro copia o link de indicação e pode anexar uma oferta de vínculo (teto e forma de cobrança). A organização criada pelo link recebe o convite; recusá-lo não cancela a indicação. A recompensa de quem indicou pode ir para os créditos (padrão) ou para o ledger, conforme a preferência do parceiro. A lista de indicações não mostra dados de cobrança das indicadas.