Pagamentos do Stripe

Procurando uma maneira rápida, segura e integrada de pagar seus afiliados diretamente em suas contas bancárias? O Stripe Payouts no AffiliateWP torna isso possível. Com uma configuração única, você pode enviar os ganhos dos afiliados diretamente através do Stripe, sem precisar de planilhas ou processamento manual.

Neste guia, mostraremos como o Stripe Payouts funciona, como configurá-lo e como enviar pagamentos.

Visão Geral do Stripe Payouts

Stripe Payouts é uma integração integrada no AffiliateWP que permite pagar seus afiliados usando o Stripe.

Você conectará sua conta Stripe no AffiliateWP, que está instalado em seu site, e seus afiliados se conectarão através da sua conta Stripe a partir da Área do Afiliado deles. Uma vez que ambos estejam conectados, você poderá iniciar os pagamentos com um único clique.

Quando você envia um pagamento, os fundos se movem de sua conta Stripe para a conta Stripe conectada do seu afiliado, e o Stripe então deposita esses fundos na conta bancária do afiliado.

Configurando o Stripe Payouts

Para começar, navegue até AffiliateWP » Configurações » Pagamentos e clique em Stripe Payouts na lista de métodos de pagamento disponíveis. Você pode clicar no botão Configurar ou clicar em qualquer lugar na linha Stripe Payouts para expandir o painel de configurações.

Quando aberto, o painel Stripe Payouts exibe três seções principais: Credenciais Ativas, Modo Sandbox e Configuração de Webhook.

• Credenciais Ativas é onde você conecta sua conta Stripe ativa para enviar pagamentos reais.
• Modo Sandbox Um ambiente de teste onde você pode simular pagamentos sem transações reais.
• Configuração de Webhook — Configurações opcionais para permitir que o AffiliateWP receba atualizações em tempo real do Stripe sobre o status da conta e transferências.

Vamos analisar cada seção.

Credenciais Ativas

Para processar pagamentos reais, você precisará conectar sua conta Stripe ativa inserindo sua Chave Secreta Ativa. Se a conexão for bem-sucedida, um sinal de verificação verde aparecerá. Se a conexão for bem-sucedida, um sinal de verificação verde aparecerá ao lado de suas credenciais.

Após inserir sua chave, ative a opção e clique em Salvar Alterações. Uma vez ativado, o Stripe estará disponível como método de pagamento.

Modo Sandbox (Ambiente de Teste)

O Modo Sandbox permite que você simule pagamentos sem processar transações reais. Isso é especialmente útil para testar sua configuração do Stripe Payouts e garantir que tudo funcione como esperado antes de ir para o ambiente de produção.

Para ativar o Modo Sandbox:

1. Ative o Modo Sandbox alternando a opção.
2. Insira sua Chave Secreta de Teste encontrada no seu Painel de Teste Stripe em Desenvolvedores » Chaves de API.

O painel também mostra:

1. Saldo de Teste Disponível: Exibe os fundos de sandbox atuais disponíveis em sua conta de teste Stripe.
2. Adicionar Fundos de Teste: Insira um valor (por exemplo, R$ 500) e clique em Adicionar Fundos para simular um saldo. Esses fundos de teste permitem que você inicie ações de pagamento sem dinheiro real.

Configuração de Webhook (recomendado)

Webhooks mantêm o AffiliateWP sincronizado com a Stripe, fornecendo atualizações em tempo real quando o status da conta de um afiliado é alterado ou quando um pagamento é enviado.

Esta seção inclui:

• Um URL do Ponto de Extremidade do Webhook que você pode copiar para a Stripe
• Um campo para colar o Segredo de Assinatura do Webhook da Stripe

Estas etapas são opcionais, mas altamente recomendadas para melhor confiabilidade e depuração.

Configurando Eventos de Webhook

Para garantir que a Stripe possa enviar atualizações em tempo real de volta para o AffiliateWP, recomendamos a configuração dos seguintes eventos ao configurar seu webhook:

Comece fazendo login no seu Painel da Stripe. No canto inferior esquerdo do painel, clique em Desenvolvedores. Em seguida, no menu lateral, selecione Webhooks.

Na página Webhooks, clique no botão Adicionar Destino para começar a configurar um novo webhook.

Na página Selecionar eventos, a Stripe solicitará que você escolha qual conta deve acionar eventos. Na seção Eventos de, certifique-se de que Sua conta esteja selecionada. Isso é pré-selecionado por padrão e garante que os eventos acionados de sua conta Stripe sejam enviados para o AffiliateWP.

Logo abaixo, você verá o campo Versão da API. No menu suspenso, selecione a versão mais recente disponível para garantir a compatibilidade com os recursos e melhorias mais recentes da Stripe.

Em seguida, na guia Todos os eventos, use o campo Encontrar evento por nome ou descrição para pesquisar nomes de eventos específicos.

Em seguida, selecione os seguintes eventos para garantir que o AffiliateWP receba as atualizações necessárias da Stripe:

• payout.paid – Notifica quando um pagamento é depositado com sucesso na conta bancária do afiliado
• payout.failed – Notifica quando um pagamento falha ao chegar ao banco do afiliado
• transfer.created – Notifica quando uma transferência é iniciada para a conta Stripe do afiliado
• transfer.reversed – Notifica quando uma transferência enviada anteriormente é revertida
• transfer.updated – Notifica quando o status ou os metadados da transferência são atualizados
• account.updated – Rastreia alterações na conta do afiliado (por exemplo, status ou informações de verificação)
• account.application.authorized – Confirma quando um afiliado conecta sua conta Stripe
• account.application.deauthorized – Dispara se o afiliado desconectar de sua conta Stripe

Depois que todos os eventos forem selecionados, prossiga clicando na guia Eventos selecionados para revisar suas escolhas.

Depois que todos os eventos forem selecionados, clique em Continuar para prosseguir para a próxima etapa.

Na tela Escolher tipo de destino, certifique-se de que Endpoint de webhook esteja selecionado. Esta opção é pré-selecionada por padrão e permite que o Stripe envie notificações de eventos para a URL do seu webhook especificada.

Na tela Configurar destino, o Stripe perguntará para onde enviar os eventos selecionados. No campo Nome do destino, insira um nome reconhecível para ajudar a identificar este webhook posteriormente. No campo URL do endpoint, cole a URL do webhook fornecida no seu painel do WordPress em: AffiliateWP » Configurações » Pagamentos » Pagamentos Stripe. Opcionalmente, você pode adicionar uma Descrição para fornecer mais contexto sobre o propósito deste webhook. Assim que tudo for preenchido, clique em Criar destino para concluir a configuração.

Assim que tudo for preenchido, clique em Criar destino para concluir a configuração.

Após clicar no botão Criar Destino, o Stripe o redirecionará automaticamente para a página de detalhes do webhook recém-criado. Na seção Segredo de assinatura, clique no ícone de olho para revelar a chave secreta.

Em seguida, clique no ícone de copiar para a área de transferência para copiá-la.

Em seguida, retorne ao seu painel do WordPress e cole a chave copiada no campo Segredo de Assinatura do Webhook em AffiliateWP » Configurações » Pagamentos » Pagamentos Stripe.

Notificações por E-mail

A integração de Pagamentos Stripe do AffiliateWP inclui notificações por e-mail integradas que mantêm administradores do site e afiliados informados sobre eventos importantes de pagamento.

Para configurar essas notificações, navegue até AffiliateWP » Configurações » E-mails e, em seguida, abra a guia E-mails de Pagamentos Stripe.

A interface é dividida em duas seções: E-mails do Gerente de Afiliados e E-mails do Afiliado.

E-mails do Gerente de Afiliados

Essas notificações são enviadas ao administrador do site (ou a quem gerencia os pagamentos de afiliados) quando o Stripe relata uma alteração no status do pagamento ou da conta.

Cada notificação tem um botão Configurar que permite personalizar a linha de assunto, o conteúdo do corpo e adicionar tags dinâmicas. Você também pode visualizar ou enviar um e-mail de teste a partir desta tela.

Aqui estão as notificações disponíveis:

• Transferência Criada Notifica os administradores quando uma transferência é iniciada com sucesso para a conta Stripe de um afiliado.
• Transferência Falhou Alerta os administradores quando uma tentativa de transferência para o Stripe falha.
• Transferência Revertida Notificação crítica quando o Stripe reverte uma transferência anteriormente bem-sucedida.
• Pagamento Concluído Enviado quando o Stripe confirma que os fundos chegaram com sucesso à conta bancária do afiliado.
• Pagamento Falhou Enviado quando um pagamento não consegue chegar à conta bancária do afiliado devido a um problema (por exemplo, conta bancária inválida).
• Verificação de Conta Necessária Alerta você quando um afiliado precisa concluir etapas adicionais de verificação para ser elegível para pagamentos.
• Conta Conectada Notifica você quando um afiliado conecta com sucesso sua conta Stripe.

E-mails de Afiliados

Estas são enviadas diretamente aos afiliados, ajudando-os a se manterem atualizados sobre o status de suas contas e pagamentos.

As notificações disponíveis incluem:

• Transferência Criada Informa aos afiliados que uma transferência foi iniciada para a conta Stripe deles.
• Transferência Falhou Notifica-os se a transferência falhou.
• Pagamento Concluído Informa aos afiliados que os fundos chegaram à conta bancária deles.
• Pagamento Falhou Alerta o afiliado que o pagamento não pôde ser concluído pelo banco dele.
• Verificação de Conta Necessária Notifica o afiliado se o Stripe exigir informações adicionais de identidade ou bancárias para habilitar pagamentos.
• Conta Conectada Uma mensagem de boas-vindas confirmando que a conta Stripe deles foi conectada com sucesso.

Cada e-mail pode ser personalizado com seu próprio assunto, mensagem e tags de modelo. Estes são acessados clicando no botão Configurar ao lado de cada notificação.

Conectando como Afiliado

Para receber pagamentos via Stripe, os afiliados devem conectar sua própria conta Stripe. Este é um processo de autoatendimento e pode ser concluído a partir da Área do Afiliado ou do Portal do Afiliado, dependendo da interface que seu site utiliza. Uma vez conectado, os pagamentos podem ser enviados automaticamente para a conta bancária do afiliado através do Stripe.

Área do Afiliado

Se o seu site usa a Área do Afiliado, os afiliados podem se conectar ao Stripe seguindo estas etapas:

1. Faça login na Área do Afiliado em seu site
2. Vá para Configurações » Pagamentos Stripe, e clique no botão Configurar Pagamentos Stripe.

Portal do Afiliado

Se o seu site usa o Portal do Afiliado, uma vez que um afiliado esteja logado, ele pode clicar no ícone de perfil no canto superior direito e clicar em Configurações.

Na tela de Configurações, localize a seção Pagamentos Stripe e clique em Configurar Pagamentos Stripe.

Processo de integração do Stripe

Após clicar em Configurar Pagamentos Stripe, os afiliados serão redirecionados para o fluxo de integração seguro do Stripe. É aqui que eles serão solicitados a fornecer verificação de identidade, informações bancárias e aceitar os termos do Stripe.

Após a conclusão, a conta Stripe do afiliado é vinculada ao seu site.

Na Área do Afiliado, o afiliado verá seu ID da Conta conectado, juntamente com opções para acessar seu Painel Stripe.

Personalizando a Página de Onboarding de Afiliados

Como administrador do site, você pode personalizar a experiência de integração hospedada pelo Stripe que os afiliados veem ao conectar suas contas. Para definir a cor da sua marca para a página de integração do Stripe:

1. Faça login no seu Painel Stripe
2. Vá para Configurações » Conectar » Interface de integração e clique em Personalizar
3. Defina seu logotipo, cor da marca e opções de destaque
4. Salve as alterações — elas serão refletidas nas páginas de integração hospedadas

Gerenciando Conexões de Afiliados

Como administrador do site, você pode visualizar e gerenciar o status da conexão de cada afiliado na tela AffiliateWP » Afiliados. Aqui você verá uma coluna de Status Stripe, que permite verificar rapidamente o status da conexão de cada afiliado em um relance, sem precisar abrir o perfil individual deles.

Passar o mouse sobre qualquer selo de status exibirá uma dica com mais detalhes sobre a conexão.

• Se o afiliado não conectou a conta, você verá um travessão (—). Passar o mouse sobre ele revelará uma dica que diz: “Afiliado não conectou sua conta Stripe.”
• Se a conexão for bem-sucedida, você verá Habilitado, juntamente com o ID da conta do afiliado, status da conexão (por exemplo, “Pagamentos: ativo, Recebimentos: ativo”) e um link Ver Detalhes.
• Se algo der errado com a conexão (por exemplo, chaves incorretas ou acesso revogado), você verá Erro, juntamente com a mensagem de erro específica.
• Um status Restrito significa que a conta do afiliado está conectada, mas algo está impedindo os pagamentos — muitas vezes devido à falta de verificação ou restrições de país.

Você pode clicar no link Ver Detalhes (disponível apenas quando o status é “Habilitado”) para abrir o painel completo de Conexão Stripe no perfil do afiliado.

Clicar no nome de qualquer afiliado o levará ao perfil dele. Aqui, você encontrará uma seção Pagamentos Stripe que mostra informações mais detalhadas com base no status da conexão dele.

O que você vê aqui depende da conexão do afiliado:

Se o afiliado não estiver conectado:

Se o afiliado não estiver conectado ao Stripe, o perfil dele exibirá o nome, um selo de status rotulado Não conectado e uma mensagem afirmando: “Conta Stripe não conectada. Este afiliado receberá pagamentos através do seu método padrão.”

Se o afiliado estiver conectado:

Os detalhes da conexão dele serão exibidos, incluindo:

• Nome e ID da Conta Stripe
• Status da conexão (Habilitado)
• Detalhes da conta (sempre “Express”), país e data de conexão
• Status de Pagamentos e Recebimentos
• Um botão Ver no Stripe para abrir o perfil deles no seu Painel do Stripe
• Um botão Desconectar para redefinir a conexão deles

Esta visualização é útil para solução de problemas, gerenciamento de conexões de afiliados e para garantir que todos estejam configurados corretamente para receber pagamentos.

Enviando Pagamentos

Depois que sua conta Stripe for conectada e os afiliados tiverem vinculado suas contas, os pagamentos poderão ser enviados diretamente do seu administrador WordPress.

Opção 1: Pagar na tela de Indicações

Vá para AffiliateWP » Indicações. Ao lado de cada indicação não paga, você verá um link Pagar via Stripe.

Clicar no link Pagar via Stripe exibirá uma caixa de diálogo de confirmação, permitindo que você revise os detalhes do pagamento antes de enviar. Esta caixa de diálogo mostra o nome do afiliado, o valor do pagamento e confirma que o pagamento será enviado para a conta Stripe conectada do afiliado.

Para concluir o pagamento, clique em Pagar Agora. Para cancelar, basta fechar o pop-up ou clicar em Cancelar.

Para pagar várias indicações de uma vez:

1. Selecione as indicações usando as caixas de seleção.
2. Abra o menu suspenso Ações em Massa.
3. Escolha Pagar Agora via Stripe e, em seguida, clique em Aplicar.

Opção 2: Usar a Tela de Pagamentos

Navegue até AffiliateWP » Pagamentos » Pagar Afiliados. Aqui você pode filtrar pagamentos por afiliado, intervalo de datas ou ganhos mínimos. Escolha Stripe como Método de Pagamento e, em seguida, clique para processar o pagamento em lote.

Quando um pagamento é iniciado, o Stripe executa duas ações:

1. Os fundos são transferidos da sua conta Stripe para a conta Stripe conectada do afiliado.
2. A partir daí, o Stripe deposita os fundos diretamente na conta bancária vinculada do afiliado.

Países Suportados

Pagamentos Stripe no AffiliateWP suportam qualquer país onde o Stripe Express esteja disponível. 
Para ver a lista completa de países suportados e seus requisitos de pagamento, visite a página de países suportados do Stripe.

Tenha em mente:

• Os afiliados devem estar localizados em um país suportado para conectar sua conta Stripe.
• Alguns países podem exigir etapas adicionais de verificação (por exemplo, documento de identidade emitido pelo governo, comprovante de endereço).

Perguntas Frequentes