Introdução
Para comerciantes com produtos por subscrição, a representação correta das comissões recorrentes determina a transparência, os pagamentos e a confiança dos parceiros. O Affilentra Pro combina software de afiliados self‑hosted com programas de comerciantes e fornece papéis, tracking, bem como funções de comissão e faturação. Este guia mostra, de forma prática, como registar eventos de subscrição no Affilentra, configurar regras de comissões recorrentes, tratar corretamente a prorratação em trocas de plano e liquidar bónus de churn ou retenção.
1. Criar a base: papéis, produto e IDs de tracking
Antes de criar regras, verifique estes pontos básicos:
- Criar papéis: Operador do software (Admin), Comerciante (Merchant) e Parceiro (Affiliate). Assegure que os comerciantes têm acesso às definições do seu programa.
- Registar o produto como subscrição: No Affilentra, defina uma ID de produto/subscription única para cada produto por subscrição. Esta ID tem de aparecer nos eventos de tracking para que os pagamentos recorrentes sejam atribuídos ao produto/parceiro corretos.
- Subscription‑ID no fluxo de pagamentos: Garanta que o seu fornecedor de pagamento envia a Subscription‑ID, a Invoice‑ID e a Transaction‑ID em cada evento de cobrança.
2. Registar eventos recorrentes: quais eventos são necessários?
Pelo menos estes eventos devem ser processados no Affilentra:
- initial_sale (primeiro pagamento/conversão do trial)
- subscription_payment (pagamento recorrente mensal/anual)
- subscription_proration (mudança de plano/crédito parcial)
- subscription_cancelled / subscription_expired
- payment_failed / chargeback / refund
Na prática implemente isto assim: o seu fornecedor de pagamentos envia webhooks para o endpoint de tracking da plataforma. Preste atenção aos seguintes campos no payload: subscription_id, transaction_id, amount, currency, event_type, timestamp, invoice_id, customer_id e, em mudanças de plano, adicionalmente previous_plan / new_plan assim como prorated_amount ou proration_days.
3. Configurar regras de comissão recorrente
Estruture as comissões em três níveis: pagamento inicial, pagamentos subsequentes e bónus especiais.
- Pagamento inicial: Defina uma regra para initial_sale (por exemplo 30 % ou um valor fixo). O pagamento é efetuado após a validação da conversão.
- Comissões mensais/anuais: Crie uma regra recorrente que dispare em cada subscription_payment. A regra pode ser percentual (por exemplo 10 % por cobrança) ou um valor fixo (por exemplo 5 €/mês).
- Controlar dependências: Permita taxas diferentes para conversões Trial→Paid, upgrades ou downgrades. Utilize metadados de produto e de plano para atribuir regras de forma granular.
Notas técnicas: Utilize o ID da subscrição como chave primária para a atribuição de parceiros. Guarde na primeira venda a associação ao parceiro (por exemplo via link de rastreio ou cupão) nos metadados da subscrição, para que pagamentos subsequentes sejam atribuídos automaticamente ao parceiro correto.
4. Tratar corretamente a prorratação em mudanças de plano
As mudanças de plano frequentemente geram valores proporcionais. Existem duas abordagens práticas para calcular a comissão:
- Baseado no valor (recomendado): A comissão é calculada a partir do montante efetivamente cobrado. Se o prestador de pagamentos fornecer prorated_amount, o valor da comissão = prorated_amount × commission_rate.
- Baseado no tempo: Se quiser calcular comissões estritamente pelo tempo de utilização, necessita de proration_days ou period_lengths. Exemplo: Comissão pro rata = (days_active / total_days) × period_commission.
Para representar a prorratação de forma segura, proceda da seguinte forma:
- O webhook do payment para mudança de plano deve conter prorated_amount e informações sobre previous_plan/new_plan.
- No Affilentra, crie uma regra de processamento que seja acionada quando event_type = subscription_proration e que calcule a comissão com base em prorated_amount.
- Configure idempotência: Verifique transaction_id e invoice_id para evitar cobranças em duplicado.
Exemplo de cálculo: taxa de comissão 10 %, prorated_amount = 15,00 € → Comissão = 1,50 €. Documente no histórico da transação a base (prorated_amount, previous_period, new_period) para rastreabilidade.
5. Gestão do churn: cobranças de devolução & bónus de retenção
Uma gestão limpa do churn abrange dois aspetos: clawbacks (recuperações) em caso de cancelamento/reembolso e incentivos positivos para retenção.
Clawbacks e ajustes
- Em caso de refund, chargeback ou subscription_cancelled, o Affilentra deve gerar uma entrada de correção: comissão negativa ou marcação de estorno.
- Política: Decida se, no caso de um refund, apenas a última comissão é estornada ou se é aplicado um estorno proporcional por várias períodos. Implemente a regra como lógica de Adjustment automatizada que reaja a eventos de refund.
Bónus de retenção
- Pague bónus de retenção quando um parceiro contribui ativamente para a retenção do cliente (p.ex. reativação após pedido de cancelamento, upsell, intervenção bem‑sucedida do suporte).
- Implementação técnica: Defina um evento desencadeador retention_success (manual ou automatizado pelo seu CRM/suporte) que inicie um pagamento de bónus. O bónus pode ser um valor fixo ou percentual sobre a próxima cobrança.
- Escalonamento: Pague bónus escalonados, por exemplo, bónus menor se o cliente permanecer >30 dias, bónus maior se >90 dias.
6. Reconciliação, reporting e pagamentos
Estabeleça processos de reconciliação regulares:
- Exporte listas de transacções com Subscription‑ID, parceiro, tipo de evento, montante, comissão e estado (paid/adjusted/pending).
- Verifique itens em aberto: pagamentos falhados e cobranças pendentes devem ser regularizados antes do pagamento.
- Utilize a função de faturação do Affilentra para criar lançamentos de pagamento. Defina ciclos de pagamento (mensal, semanal) e estabeleça limites mínimos de pagamento.
7. Testes e Boas Práticas
- Ambiente de teste: simule todos os eventos de webhook relevantes (initial_sale, subscription_payment, proration, refund, cancel) e verifique os resultados no histórico do parceiro.
- Idempotência: verifique IDs de transacção antes de registar para evitar duplicados.
- Documentação: armazene metadados (p. ex. original_invoice_id, coupon, material promocional) para verificações posteriores.
- Transparência: disponibilize aos parceiros um histórico de pagamentos auditável (links de tracking, períodos, deduções por reembolsos).
- Proteção de dados & conformidade: atente para o armazenamento de dados de clientes conforme o RGPD e pseudonimise sempre que possível.
Conclusão e passos de implementação
Affilentra Pro fornece a infraestrutura necessária para mapear internamente subscrições, prorrata e lógica de churn. Resumindo, os próximos passos são:
- Registar IDs de Produto/Subscription no Affilentra e guardar a atribuição do parceiro na primeira compra.
- Implementar a integração de webhook com o fornecedor de pagamentos e enviar todos os campos relevantes (especialmente subscription_id, transaction_id, prorated_amount).
- Configurar regras de comissão para o pagamento inicial e pagamentos recorrentes; processar eventos de prorrata de modo que as comissões se baseiem no prorated_amount.
- Introduzir e automatizar ajustes de churn e bónus de retenção como eventos desencadeados.
- Realizar testes extensivos e configurar reporting/conciliamento para pagamentos.
Se estiver pronto para gerir o seu programa de afiliados para subscrições de forma segura e transparente, escolha a sua entrada: Escolher entrada.
Próximo passo
Experimentar o Affilentra
Plataforma unificada que agrega de forma transparente disponibilização de produto, tracking, validação de conversões, cálculo de comissões e pagamentos com papéis claramente separados; opção de instalação self-hosted com licença perpétua sem partilha de receita; os comerciantes mantêm o controlo sobre produtos, condições e materiais promocionais; os parceiros recebem links de tracking pessoais e histórico de pagamentos auditável.