--- title: "Agente de pagamentos: documentação do Spark! | Chargezen" description: "Cálculo, processamento e pagamento automático de comissões com histórico completo para auditoria" url: "https://chargezen.com/pt-br/docs/spark/ai-agents/payout-agent" lang: "pt-BR" updated: "2026-01-19" --- Canonical URL: https://chargezen.com/pt-br/docs/spark/ai-agents/payout-agent # Agente de pagamentos Cálculo, processamento e pagamento automático de comissões com histórico completo para auditoria Última atualização: 2026-01-19 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. Facilidade de auditoria Cada cálculo de comissão é registrado com a justificativa completa: regras aplicadas, bônus adicionados e tratamento dos reembolsos. Isso facilita a conformidade fiscal, as disputas com afiliados e as auditorias financeiras. ## O que faz 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 ## Cálculo de comissões 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 ### Ordem de prioridade das comissões 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) ## Ciclo das comissões As comissões passam por vários status: ### Pendente * **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" ### Aprovado * **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" ### Held * **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" ### Processamento * **Quando:** Lote de pagamentos iniciado * **Duração:** Até a confirmação do pagamento * **Visível para:** O afiliado vê como "Processing" ### Pago * **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 ### Reversed * **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 ## Tratamento de reembolsos O Payout Agent ajusta automaticamente as comissões quando há reembolso de pedidos: ### Reembolso total * **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" ### Reembolso parcial * **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" ### Contestação de pagamento * **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 Período de carência O período de carência padrão é de 30 dias. Durante esse tempo, as comissões ficam em "Pending" para permitir reembolsos. Só depois desse período passam a "Approved" e ficam elegíveis para pagamento. Ajuste em **Payouts → Settings → Grace Period**. ## Processamento de pagamentos 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 ## Métodos de pagamento O Payout Agent oferece vários métodos de pagamento: ### PayPal * **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 ### Transferência bancária (ACH) * **Prazo:** 2 a 3 dias úteis * **Cobertura:** Apenas bancos dos EUA * **Tarifas:** Menores que as do PayPal * **Requisitos:** Integração com Stripe Connect ### Transferência wire * **Prazo:** 3 a 5 dias úteis * **Cobertura:** Internacional * **Tarifas:** US$25 a US$50 por transferência * **Ideal para:** Pagamentos internacionais de alto valor ### Crédito na loja * **Prazo:** Imediato * **Formato:** Cartão-presente da Shopify * **Tarifas:** Nenhuma * **Bônus:** Opção de oferecer bônus percentual por crédito na loja ## Documentação fiscal O Payout Agent gerencia a conformidade fiscal: ### Coleta do W-9 (EUA) * **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 ### Geração de 1099 * **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 ### Internacional * **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 ## Configurações Acesse as configurações em **AI → Agent Insights → Payout Agent → Settings**. ### Calendário de pagamentos * **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 ### Limites mínimos de pagamento * **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) ### Período de carência * **Duration** — Dias até a confirmação da comissão (padrão: 30) * **Override** — Período menor para afiliados de confiança ## Relatórios e documentação 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 ## Métricas de desempenho #### Principais métricas * Commissions Processed — Total de comissões calculadas (por período) * Payout Volume — Valor total pago * Avg. Commission — Comissão média por pedido * Payout Accuracy — Porcentagem de pagamentos sem disputas * Processing Time — Tempo entre aprovação e pagamento * Refund Rate — Porcentagem de comissões revertidas * Tax Compliance — Porcentagem com os documentos fiscais exigidos ## Boas práticas ### Defina um período de carência adequado * 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 ### Mantenha a conformidade fiscal * 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 ### Comunique-se com clareza * Defina expectativas claras sobre os prazos de pagamento nos termos * Envie confirmações de pagamento prontamente * Explique retenções ou atrasos de forma proativa ## Solução de problemas ### Pagamentos com falha * 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 ### Comissão ausente * 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 ## Próximos passos [ ### Visão geral dos pagamentos Configure os pagamentos Saiba mais ](https://chargezen.com/pt-br/docs/spark/payouts/overview)[ ### Agente antifraude Proteja-se contra fraudes em comissões Saiba mais ](https://chargezen.com/pt-br/docs/spark/ai-agents/fraud-agent) ### Artigos relacionados [ #### Visão geral dos pagamentos Visão geral do sistema de pagamentos ](https://chargezen.com/pt-br/docs/spark/payouts/overview)[ #### Agente antifraude Detecção de fraudes ](https://chargezen.com/pt-br/docs/spark/ai-agents/fraud-agent)[ #### Visão geral dos agentes de IA Todos os agentes ](https://chargezen.com/pt-br/docs/spark/ai-agents/overview) Esta página foi útil? Precisa de mais ajuda? [Fale com o suporte](https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/support)