Documentação do WP Simple Pay

Documentação, Materiais de Referência e Tutoriais para o WP Simple Pay

Como Usar o Bloco Gerenciar Assinaturas

Tempo de leitura: 4 minutos | Dificuldade: Iniciante

Visão Geral

O bloco Gerenciar Assinaturas permite incorporar um pequeno formulário em qualquer página onde os clientes possam solicitar acesso a uma página de gerenciamento de assinaturas de autoatendimento. Eles inserem o endereço de e-mail usado na compra, e o WP Simple Pay envia um link seguro e sem senha para atualizar o método de pagamento, alterar os detalhes de faturamento ou cancelar a assinatura — tudo isso sem criar uma conta no WordPress ou entrar em contato com o suporte.

Este é o lado do cliente em contrapartida ao e-mail Gerenciar Assinaturas e às configurações globais de Gerenciamento de Assinaturas. Coloque este bloco em uma página (por exemplo, /gerenciar-assinatura) e vincule-o ao seu rodapé, e-mails de clientes e páginas de confirmação pós-compra.

Pré-requisitos

Etapa 1: Inserir o Bloco

  1. Edite a página onde você deseja que o formulário apareça (por exemplo, uma página dedicada "Gerenciar Minha Assinatura").
  2. Clique no inseridor de blocos +.
  3. Procure por Gerenciar Assinaturas e selecione o Bloco Gerenciar Assinaturas.

O bloco é inserido imediatamente com texto padrão e um botão de envio.

Etapa 2: Personalizar Rótulos (Opcional)

Na barra lateral do bloco, você pode substituir três strings de texto:

  • Rótulo — O rótulo acima do campo de e-mail. Padrão: Endereço de E-mail da Compra.
  • Placeholder do E-mail — Texto de placeholder exibido dentro do campo de e-mail. Padrão: Digite seu e-mail.
  • Texto do Botão — Texto do botão de envio. Padrão: Gerenciar Assinatura.

Personalize estes campos para que correspondam ao tom do seu site — por exemplo, altere o texto do botão para Envie-me um Link de Login para definir a expectativa correta.

Etapa 3: Publicar a Página

Salve a página e visite o URL do frontend. Os clientes verão um único campo de e-mail e um botão de envio, opcionalmente protegido por um desafio CAPTCHA se você ativou um em Configurações > Geral > 🛡️ Anti-Spam.

Usando o Shortcode (Editor Clássico e Construtores de Páginas)

Adicionado no WP Simple Pay 4.17.3.

Se o seu site usa o Editor Clássico, um construtor de páginas que não renderiza blocos Gutenberg (alguns temas legados, configurações somente de shortcode, certas configurações do Elementor/Divi), ou se você deseja incorporar o formulário dentro de um template existente, use o shortcode em vez disso:

[simpay_manage_subscriptions]

O shortcode renderiza o formulário Gerenciar Assinaturas idêntico ao bloco — mesmo campo de e-mail, mesmo fluxo CAPTCHA, mesmo fluxo de link por e-mail. Coloque-o em qualquer lugar onde um shortcode seja aceito: dentro de uma postagem do Editor Clássico, uma parte do template, um widget ou um bloco de texto do construtor de páginas.

Você pode usar o bloco ou o shortcode (ou ambos, se você mantiver páginas criadas com editores diferentes). Ambos produzem saídas idênticas e compartilham as mesmas configurações anti-spam.

Como Funciona a Experiência do Cliente

  1. O cliente visita sua página Gerenciar Assinatura.
  2. Eles inserem o endereço de e-mail que usaram para comprar a assinatura.
  3. O WP Simple Pay verifica se existe uma assinatura para esse e-mail e agenda o e-mail Gerenciar Assinaturas.
  4. O e-mail chega com um link seguro e com tempo limitado.
  5. Clicar no link abre o portal voltado para o cliente, onde eles podem:
    • Atualizar método de pagamento (cartão, conta bancária, etc.)
    • Atualizar endereço de faturamento
    • Cancelar a assinatura
  6. Assim que o link for usado ou o tempo expirar, ele se torna inválido e um novo deve ser solicitado.

O fluxo é intencionalmente sem senha — os clientes não precisam de uma conta WordPress, e você não precisa gerenciar funções de usuário para clientes pagantes.

Proteção Anti-Spam

O bloco se integra automaticamente ao provedor CAPTCHA configurado em suas configurações Anti-Spam (Google reCAPTCHA v3, hCaptcha ou Cloudflare Turnstile). O desafio CAPTCHA é renderizado dentro do formulário e verificado no lado do servidor antes que o e-mail seja enviado. Recomendamos fortemente ativar o CAPTCHA neste bloco — ele evita abusos onde bots inundam as caixas de entrada dos assinantes com e-mails de link mágico.

Se nenhum provedor CAPTCHA estiver configurado, o formulário ainda funciona, mas está aberto a envios automatizados.

Locais comuns para a página de gerenciamento de assinatura:

  • Rodapé — Link permanente “Gerenciar Assinatura” visível em todas as páginas.
  • E-mails do cliente — Refira-se ao URL no Conteúdo do Rodapé do template de e-mail (Configurações > E-mails > Geral).
  • Página de confirmação — Adicione o link à cópia de Confirmação de Pagamento no site para que os clientes a vejam imediatamente após a compra.
  • Página da conta — Se o seu site tiver uma área de membro ou conta, vincule a página de gerenciamento a partir dali.

Perguntas Frequentes

E se o e-mail não corresponder a nenhuma assinatura?

O WP Simple Pay retorna uma confirmação genérica, independentemente de existir uma assinatura para o e-mail — isso é intencional, para evitar ataques de enumeração onde alguém sonda e-mails válidos de clientes. O cliente simplesmente não receberá um e-mail se nenhuma assinatura corresponder.

Os links têm prazo limitado. A expiração específica depende das suas configurações, mas geralmente são de curta duração (horas, não dias) para que um link vazado não possa ser reutilizado indefinidamente.

Sim. O portal suporta atualizações de método de pagamento, alterações de endereço de faturamento e cancelamento de assinatura. As ações disponíveis correspondem às capacidades padrão do Portal do Cliente Stripe.

Isso funciona para pagamentos únicos?

Não. Este bloco é especificamente para gerenciamento de assinaturas. Pagamentos únicos não têm um relacionamento contínuo para gerenciar. Para recibos de pagamento único, use a ferramenta Reenviar Recibo de Pagamento em Configurações > E-mails > Ferramentas (veja Referência de Tipos de E-mail).

Por que o bloco não está visível no inseridor?

O bloco é registrado pelo plugin Pro. Se você estiver usando a versão gratuita, o bloco não aparecerá. Verifique se sua licença está ativa em Configurações > Geral > Licença.

Posso estilizar o formulário?

O bloco usa a estilização padrão de blocos do WordPress para o botão (ele herda os estilos .wp-block-button do tema), e os campos de entrada usam os estilos de formulário padrão do seu tema. Para personalização mais aprofundada, use o seletor #simpay-manage-subscription-form no CSS do seu tema.

Próximos Passos?

Ainda tem d uevovidas? Estamos aqui para ajudar!

Última Modificação:

Comece a Aceitar Pagamentos Hoje

Comece a aceitar pagamentos únicos e recorrentes ou doações em seu site WordPress.