Agente de pagamentos

O Payout Agent automatiza os cálculos de comissões, trata reembolsos e contestações, processa pagamentos em massa conforme o calendário e gera documentos fiscais, tudo com histórico completo para auditoria e conformidade. Ele garante pagamentos precisos e pontuais aos afiliados.

O Payout Agent gerencia todo o ciclo das comissões:

• Cálculo de comissões — Calcula as comissões com base nas suas regras
• Aplicação de níveis — Aplica bônus por nível e taxas específicas por produto
• Tratamento de reembolsos — Ajusta comissões por reembolsos e contestações
• Integração antifraude — Respeita as retenções e pontuações de risco do Fraud Agent
• Pagamentos em massa — Processa pagamentos no calendário configurado
• Documentação fiscal — Gera formulários 1099, coleta W-9 e gerencia formulários internacionais
• Histórico de auditoria — Registro completo de cada transação

Para cada pedido atribuído, o Payout Agent executa estas etapas:

1. Identificar o afiliado
   • Determinar a qual afiliado o pedido foi atribuído
   • Verificar se o afiliado está ativo e em situação regular
2. Determinar a taxa
   • Verificar se há uma taxa de comissão específica para o produto
   • Verificar se há uma taxa específica para a coleção
   • Verificar se há uma taxa promocional ou de campanha
   • Na ausência dessas taxas, usar a taxa do nível do afiliado
   • Aplicar o bônus de nível, se cabível
3. Calcular a base
   • Aplicar a taxa ao valor do pedido (excluindo frete e impostos, se configurado)
   • Tratar comissões percentuais ou de valor fixo
4. Aplicar modificadores
   • Bônus pelo primeiro pedido (se configurado)
   • Bônus por volume (se cabível)
   • Multiplicadores promocionais
5. Verificar a pontuação de fraude
   • Consultar a avaliação de risco do Fraud Agent
   • Reter se a pontuação estiver acima do limite
6. Registrar a comissão
   • Criar o registro da comissão com todos os detalhes do cálculo
   • Definir o status: Pending, Approved ou Held

Quando várias taxas podem se aplicar, o agente usa esta prioridade:

1. Taxa específica do afiliado (se definida para ele)
2. Taxa específica do produto (se definida para ele)
3. Taxa específica da coleção (se o produto pertencer a uma coleção especial)
4. Taxa de campanha ou promoção (se houver promoção ativa)
5. Taxa do nível (nível atual do afiliado)
6. Taxa padrão do programa (na ausência das anteriores)

As comissões passam por vários status:

• Quando: Pedido feito, dentro do período de carência
• Duração: 30 dias por padrão (configurável)
• Finalidade: Dar tempo para reembolsos e contestações
• Visível para: O afiliado vê como "Pending"

• Quando: Período de carência encerrado, sem reembolso e com baixo risco de fraude
• Transição: Aprovação automática ou manual
• Status: Pronta para processamento do pagamento
• Visível para: O afiliado vê como "Approved"

• Quando: Sinalização do Fraud Agent, retenção manual ou disputa
• Ação: Exige revisão manual para aprovar ou rejeitar
• Visível para: O afiliado vê como "Under Review"

• Quando: Lote de pagamentos iniciado
• Duração: Até a confirmação do pagamento
• Visível para: O afiliado vê como "Processing"

• Quando: Pagamento entregue com sucesso
• Registro: Método de pagamento, ID da transação e data
• Visível para: O afiliado vê a confirmação do pagamento

• Quando: Reembolso processado, contestação recebida ou fraude confirmada
• Ação: Comissão deduzida do saldo
• Tratamento: Pode gerar saldo negativo para compensação futura

O Payout Agent ajusta automaticamente as comissões quando há reembolso de pedidos:

• Ação: Comissão totalmente revertida
• Momento: Durante o período de carência: comissão cancelada; depois: gera ajuste negativo
• Visão do afiliado: Comissão marcada como "Reversed - Refund"

• Ação: Comissão ajustada proporcionalmente
• Cálculo: Nova comissão = original × (novo valor do pedido / valor original)
• Visão do afiliado: Comissão marcada como "Adjusted - Partial Refund"

• Ação: Comissão revertida, penalidade opcional
• Penalidade: Configurável — alguns programas deduzem uma tarifa adicional
• Detecção de padrões: Altas taxas de contestação são sinalizadas para revisão

Nos dias de pagamento, o agente executa estas etapas:

1. Somar as comissões
   • Somar todas as comissões aprovadas de cada afiliado
   • Subtrair saldos negativos ou ajustes
2. Verificar os limites
   • Verificar se o saldo atinge o mínimo para pagamento
   • Aplicar limites específicos por nível no lugar do padrão
3. Verificar os requisitos
   • Documentos fiscais cadastrados (W-9 nos EUA)
   • Método de pagamento configurado
   • Conta em situação regular
4. Processar o pagamento
   • Iniciar o pagamento pelo método configurado
   • PayPal: API Mass Payouts
   • Banco: ACH/wire pelo Stripe Connect
   • Crédito na loja: gerar cartão-presente
5. Confirmar a entrega
   • Aguardar a confirmação do pagamento
   • Tratar falhas e novas tentativas
6. Notificar o afiliado
   • Enviar e-mail de confirmação do pagamento
   • Atualizar o portal com os detalhes do pagamento

O Payout Agent oferece vários métodos de pagamento:

• Prazo: Imediato a poucas horas
• Cobertura: 200 países ou mais
• Tarifas: Aproximadamente 2% por transação
• Requisitos: Conta PayPal Business com Mass Payouts habilitado

• Prazo: 2 a 3 dias úteis
• Cobertura: Apenas bancos dos EUA
• Tarifas: Menores que as do PayPal
• Requisitos: Integração com Stripe Connect

• Prazo: 3 a 5 dias úteis
• Cobertura: Internacional
• Tarifas: US$25 a US$50 por transferência
• Ideal para: Pagamentos internacionais de alto valor

• Prazo: Imediato
• Formato: Cartão-presente da Shopify
• Tarifas: Nenhuma
• Bônus: Opção de oferecer bônus percentual por crédito na loja

O Payout Agent gerencia a conformidade fiscal:

• Quando: Obrigatório antes do pagamento para afiliados nos EUA com ganhos de US$600 ou mais
• Coleta: Formulário integrado no portal do afiliado
• Armazenamento: Seguro e criptografado
• Lembrete: Lembretes automáticos de formulários ausentes

• Quando: Todo janeiro, referente ao ano anterior
• Limite: Ganhos de US$600 ou mais
• Formato: 1099-NEC
• Entrega: E-mail ao afiliado e disponibilização no portal

• W-8BEN: Para afiliados fora dos EUA (benefícios de tratados fiscais)
• Retenção: Configurável conforme os tratados fiscais
• Documentação: Resumos anuais de pagamentos

Acesse as configurações em AI → Agent Insights → Payout Agent → Settings.

• Weekly — Toda segunda-feira (ou no dia configurado)
• Bi-weekly — A cada duas semanas
• Monthly — Dia 1 de cada mês (ou no dia configurado)
• Manual Only — Sem pagamentos automáticos

• Minimum Balance — Mínimo para iniciar o pagamento (padrão: US$50)
• Tier Overrides — Mínimos menores para níveis superiores
• Method Minimums — Mínimos por método (por exemplo, US$100 para wire)

• Duration — Dias até a confirmação da comissão (padrão: 30)
• Override — Período menor para afiliados de confiança

O Payout Agent gera relatórios completos:

• Payout Summary — Cada lote de pagamentos com totais e detalhes
• Commission Report — Todas as comissões por período, afiliado e status
• Tax Report — Ganhos anuais por afiliado para preparar o 1099
• Audit Log — Cada cálculo de comissão e mudança de status
• Refund Report — Todos os ajustes e reversões

• Ajuste à sua janela típica de reembolso
• Considere o tipo de produto (maior para itens que exigem mais ponderação antes da compra)
• Equilibre a satisfação dos afiliados com a proteção contra fraudes

• Exija W-9 antes do primeiro pagamento a afiliados nos EUA
• Gere e envie os formulários 1099 até 31 de janeiro
• Guarde os registros por 7 anos

• Defina expectativas claras sobre os prazos de pagamento nos termos
• Envie confirmações de pagamento prontamente
• Explique retenções ou atrasos de forma proativa

• Verifique se o método de pagamento do afiliado é válido
• Para PayPal: verifique se o e-mail está correto e confirmado
• Para bancos: confira os números de roteamento e da conta
• Confira a mensagem de erro nos detalhes do pagamento

• Verifique se o pedido foi atribuído corretamente
• Verifique se o afiliado estava ativo no momento do pedido
• Confira se a comissão está no status "Pending"
• Revise o histórico de auditoria do pedido