Afiliados
Um Afiliado é uma organização que participa do programa de parceiros da MIDDAG. Afiliados indicam novos clientes e recebem comissões sobre as vendas resultantes. O programa de afiliados é alimentado pelo SolidAffiliate (um plugin WordPress) como fonte de verdade, com o MIDDAG Account fornecendo a integração de entitlements e a visibilidade no portal.
Como o programa de afiliados funciona
- Uma organização se inscreve para participar do programa de parceiros (via portal ou convite do admin).
- Um admin analisa e aprova a inscrição.
- Após a aprovação, um entitlement AFL é criado automaticamente (ex.:
AFL-2026050001). - O afiliado recebe um código e link de indicação únicos.
- Quando um cliente indicado realiza uma compra, o SolidAffiliate rastreia a indicação e calcula a comissão.
- O MIDDAG Account lê os dados de indicação e comissão e os exibe no portal.
SolidAffiliate como fonte de verdade
O SolidAffiliate gerencia todos os dados de afiliados: cadastros, rastreamento de indicações, cálculos de comissão e processamento de pagamentos. O MIDDAG Account nunca escreve nas tabelas do SolidAffiliate. Em vez disso, ele lê dados por meio de um adaptador e reage aos hooks WordPress do SolidAffiliate.
| Dados | Fonte de verdade | Papel do MIDDAG Account |
|---|---|---|
| Cadastro de afiliado | SolidAffiliate | Escuta o hook, registra para auditoria |
| Aprovação de afiliado | SolidAffiliate | Cria entitlement AFL |
| Rastreamento de indicação | SolidAffiliate | Lê para exibição no portal |
| Cálculo de comissão | SolidAffiliate | Lê para exibição no portal |
| Processamento de pagamento | SolidAffiliate | Lê para exibição no portal |
O único dado que o MIDDAG Account persiste é o registro do entitlement AFL.
Ciclo de vida do afiliado
| Status | O que significa | Entitlement AFL |
|---|---|---|
| Pending | Inscrição enviada, aguardando análise. | Ainda não criado. |
| Active | Aprovado e participando. Link de indicação está ativo. | Active |
| Suspended | Temporariamente pausado pelo admin. | Suspended |
| Terminated | Encerrado permanentemente. Sem mais indicações. | Cancelled |
O status do entitlement AFL espelha o status do afiliado: quando o afiliado é suspenso, o entitlement é suspenso; quando encerrado, o entitlement é cancelado.
Rastreamento de indicações
Quando um cliente indicado conclui uma compra, o SolidAffiliate registra a indicação com:
- O afiliado que indicou
- O pedido que gerou a comissão
- O valor da comissão
- O status da indicação (pending, approved, paid)
O MIDDAG Account lê esses dados por meio do AffiliateAdapter e os exibe na visualização do portal do afiliado.
Comissão e pagamentos
As taxas de comissão são configuráveis por afiliado (armazenadas no SolidAffiliate). A visualização do portal do afiliado mostra:
- Total acumulado — comissões acumuladas ao longo da vida
- Pendente — comissões aguardando aprovação ou pagamento
- Pago — comissões já desembolsadas
- Histórico de pagamentos — registros individuais de pagamento com datas e valores
Hooks consumidos
O MIDDAG Account escuta estes hooks do SolidAffiliate:
| Hook | Quando dispara | Ação do MIDDAG Account |
|---|---|---|
solid_affiliate/affiliate/registered | Novo afiliado se cadastra | Log de auditoria |
solid_affiliate/affiliate/approved | Afiliado aprovado | Criar entitlement AFL |
solid_affiliate/referral/created | Nova indicação registrada | Capturar dados da indicação |
solid_affiliate/referral/status_changed | Status da indicação muda | Atualizar projeção local |
solid_affiliate/payout/completed | Pagamento processado | Atualizar histórico de pagamentos |
Visibilidade no portal
No portal do cliente, afiliados veem:
- Código e link de indicação
- Taxa de comissão
- Lista de indicações (com status e valores)
- Resumo de comissões (acumulado, pendente, pago)
- Histórico de pagamentos
Esses dados são somente leitura no portal — todas as alterações fluem pela interface admin do SolidAffiliate ou pelos hooks.
O que os admins veem
No admin do WordPress, a visualização de gestão de afiliados mostra:
- Nome da organização
- Status do afiliado (pending, active, suspended, terminated)
- Código do entitlement AFL
- Código de indicação
- Taxa de comissão
- Valores totais acumulados e pendentes
Admins aprovam, suspendem ou encerram afiliados pela interface admin do SolidAffiliate. O entitlement AFL é atualizado automaticamente via hooks.
Dependência
O domínio Afiliado requer que o plugin SolidAffiliate esteja instalado e ativo. Se o SolidAffiliate não estiver presente, todo o domínio Afiliado é desabilitado — nenhuma página de afiliado aparece no admin ou portal, e nenhum entitlement AFL é criado.
Páginas relacionadas
- Entitlements — o entitlement AFL criado para cada afiliado ativo
- Entitlement Classes — detalhes da classe AFL
- Organizações — a entidade que participa do programa
- Pedidos — as compras que geram comissões de indicação