Pagamento de comissões (multinível)
Pré-requisitos de acesso
- Permissão (módulo):
viewCommissionsOUmanageCommissions - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Comissões e Recompensas
O que é / quando usar
Tela de auditoria das comissões multinível já geradas. Cada linha é uma comissão criada pelo motor multinível (entidade multilevel_commissions) e agrega seus pagamentos individuais por nível (multilevel_commissions_payments).
Use quando precisar conferir quanto foi gerado de comissão, para qual usuário, em qual moeda/asset, e quantos pagamentos compõem aquela comissão. É uma tela de leitura — não cria nem reprocessa pagamentos.
Pré-condições
- Permissão:
viewCommissionsoumanageCommissionscadastrado para a role do operador (permissão dupla: enum CPM no backend + módulo dinâmico no DB). - Licença/Feature: Nenhuma.
- Dependências de outras telas: as comissões só existem se houver níveis configurados em Configuração de comissões e ações de usuários-final que disparem o motor.
Passo a passo
- Acesse o menu Comissões e Recompensas → Pagamento de comissões (
/manage-multilevel-commissions). - A tela carrega as comissões e as enriquece com o e-mail do usuário (cruzando
userIdcom a lista de usuários) e o nome do asset (cruzandounit_of_moneycom a lista de assets). - Use a busca para filtrar por e-mail,
userId, motivo (reason) ouid. - Clique no ícone de visualizar pagamentos em uma linha para abrir o modal com a quebra por pagamento.
- Use Exportar CSV para baixar a listagem completa (data, e-mail, valor, moeda, nº de pagamentos).
Filtros e colunas
| Filtro / Coluna | O que mostra | Origem do dado |
|---|---|---|
| Busca | Filtra por e-mail, userId, reason ou id da comissão | Filtro client-side sobre a lista carregada |
Data (when) | Quando a comissão foi gerada | multilevel_commissions.when (CPM) |
| Usuário / E-mail | Usuário beneficiário da comissão | userId enriquecido com email via lista de usuários |
Valor (amount) | Valor total da comissão | multilevel_commissions.amount, exibido via BigNumber com 2 casas |
Moeda (unit_of_money) | Asset/moeda da comissão | Quando o id tem mais de 20 caracteres é resolvido para o nome do asset; caso contrário exibe o próprio código |
| Nº de pagamentos | Quantidade de pagamentos que compõem a comissão | payments.length |
Ações e modais
- Visualizar pagamentos: abre o modal
Payments, listando cadamultilevel_commissions_paymentsda comissão com usuário (e-mail), valor e status de processamento. É somente leitura. - Exportar CSV: gera um arquivo
multilevel-commissions_<data>.csvcom as colunas da listagem, no client.
Regras de negócio / cuidados
Atenção
- O campo moeda pode aparecer como um UUID quando o asset não estiver na lista carregada — nesse caso o id é exibido cru. Confirme o asset em Detentores de tokens se houver dúvida.
- A flag
wasProcessedpor pagamento indica se o crédito já foi efetivado. Pagamentos pendentes ainda não foram liquidados.
- Valores financeiros: todos os valores são BigNumber — a interface formata com 2 casas apenas para exibição; não use o valor exibido para conferência contábil sem checar a precisão original.