 |
Resumo | O plugin Discourse Subscriptions permite que proprietários de sites vendam assinaturas recorrentes e de compra única que concedem acesso a um grupo em uma instância do Discourse. |
 |
Guia de Instalação | Este plugin já vem incluído no núcleo do Discourse. Não há necessidade de instalá-lo separadamente. |
O plugin Discourse Subscriptions permite criar assinaturas de compra única e recorrentes que os usuários podem pagar para acessar conteúdo restrito. Essa pode ser uma ótima maneira de financiar os custos de hospedagem da sua comunidade.
Funcionalidades
O plugin Discourse Subscriptions suporta as seguintes funcionalidades:
- Criar novos produtos e planos no painel administrativo
- Cancelar e reembolsar assinaturas no painel administrativo
- Criar planos de assinatura de compra única ou recorrente
- Adicionar testes gratuitos em assinaturas recorrentes
- Suporte a SCA/3D Secure
- Adicionar/remover usuários de grupos de planos conforme eles se inscrevem/cancelam
- Cancelar assinatura a partir do perfil do usuário
- Cancelamento da assinatura ao final do período de assinatura
- Suporte opcional ao Stripe Checkout
- Cálculo e cobrança automática de impostos sobre vendas
- Usuários podem atualizar seu cartão para assinaturas individuais
O botão “Inscrever-se” localizado na navegação superior levará você à página de Inscrição /s, onde são listadas as assinaturas configuradas para seu site:
Assim que um usuário clicar no botão “Inscrever-se” de um plano específico, a página de pagamento desse plano será aberta:
Após o usuário preencher seus dados de pagamento e endereço e clicar em “Inscrever-se”, uma mensagem de “Obrigado!” será exibida e ele será redirecionado para sua página de faturamento:
O usuário também é automaticamente adicionado a um grupo de sua escolha, permitindo que você veja facilmente quais usuários se inscreveram e forneça conteúdo restrito em categorias que apenas esse grupo pode ver.
Termos
- Assinatura - As assinaturas são planos de pagamento recorrente que permitem controlar o acesso ao conteúdo na sua comunidade. Quando uma assinatura é criada ou excluída, um usuário é adicionado ou removido do grupo de usuários associado ao seu plano de assinatura. Uma assinatura é composta por um produto e planos.
- Produto - Um produto, nos termos do Stripe, é o que você está vendendo. Um produto pode conter um ou mais planos.
- Para adicionar uma descrição ao seu produto, adicione um campo de metadados chamado “description” e use-o. Você pode usar Markdown.
- Plano - Um plano contém um preço, um ciclo recorrente e é associado a um grupo ao qual seus assinantes terão acesso.
Tenha muito cuidado para manter suas chaves privadas do Stripe seguras e protegidas o tempo todo.
Se você desativar sua instância do Discourse, desinstalar este plugin ou seu site ficar offline, o Stripe continuará cobrando seus clientes pelo seu serviço até que a assinatura seja cancelada.
Configuração
- Instale e ative o plugin
- Configure o Gateway de Pagamento (Stripe)
- Configure Webhooks e Eventos no Stripe
- Adicione suas chaves do Stripe (pública, secreta, segredo do webhook) em Admin > Plugins > Instalados > Assinaturas > Configurações
/admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions. - Crie um grupo para seus assinantes se juntarem via compra
- Crie um produto e um plano em Admin > Plugins > Assinaturas
- Lucro!
Configure seu Gateway de Pagamento.
Primeiro, você precisará de uma conta com o gateway de pagamento Stripe. Para começar, você pode configurar uma conta no modo de teste e ver como tudo funciona sem realizar transações reais ou precisar configurar uma conta bancária. Não há um interruptor de modo de teste no plugin; em vez disso, certifique-se de usar suas chaves de desenvolvedor (elas começam com pk_test, sk_test)
Configure Webhooks e Eventos na sua conta do Stripe
Webhooks são necessários para que os cancelamentos de assinatura funcionem completamente. Certifique-se de configurá-los corretamente.
Depois de ter uma conta no Stripe, você precisará informar ao Stripe o endereço do seu site para que ele possa notificá-lo sobre certas transações. Você pode inserir isso no painel do Stripe em Endpoints > URL.
Endereço do Webhook: [seu endereço de servidor]/s/hooks – onde [seu endereço de servidor] é a URL da sua instalação do Discourse.
Você também precisará informar ao Stripe quais eventos ele deve notificá-lo via URL do webhook.
Atualmente, o Discourse Subscriptions responde aos seguintes eventos:
customer.subscription.deletedcustomer.subscription.updatedcheckout.session.completed
Adicione as chaves da API e do Webhook do Stripe às configurações do seu plugin
O Stripe precisa ser autorizado a se comunicar com seu site. Para isso, ele publica um par de chaves de API privadas e públicas e um segredo de assinatura para seus webhooks.
Para autorizar webhooks, adicione as chaves da API e o segredo do webhook do Stripe à sua página de configurações (em Desenvolvedores).
View test datae obter as chavespk_testesk_testem Desenvolvedores.
Nas configurações da sua conta do Stripe, veja:
Adicione essas chaves nas configurações apropriadas em Admin > Plugins > Instalados > Assinaturas > Configurações /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
Configure seus Grupos de Usuários no Discourse
Quando um usuário se inscreve com sucesso no seu aplicativo Discourse, após a transação do cartão de crédito ser processada, ele é adicionado a um Grupo de Usuários. Ao atribuir usuários a um Grupo de Usuários, você pode gerenciar o que seus usuários têm acesso em seu site. Grupos de usuários são uma funcionalidade central do Discourse e este plugin não faz nada com eles, exceto adicionar e remover usuários do grupo que você associou ao seu Plano.
Crie um ou mais produtos com planos.
Em Admin > Plugins > Assinaturas, clique em adicionar um novo Produto. Depois de salvar um produto, você pode adicionar planos a ele. Lembre-se de que os preços e intervalos de cobrança dos planos não podem ser alterados após a criação. Isso é para evitar confusão em torno do gerenciamento de assinaturas.
Se você der uma olhada no seu Painel do Stripe, verá que todos esses produtos e planos estão listados. O Discourse Subscriptions não os cria localmente. Eles são criados no Stripe.
Testando
Teste com estes números de cartão de crédito:
- 4242 4242 4242 4242
- 4111 1111 1111 1111 (sem autenticação necessária)
- 4000 0027 6000 3184 (autenticação necessária)
Para mais números de cartão de teste: Test card numbers | Stripe Documentation
Visite /s e realize algumas transações de teste.
Indo para Produção
Quando estiver pronto para ir para produção, altere suas chaves de API e segredo do webhook para chaves de produção. Você precisará criar novos produtos e planos no modo ao vivo.
Esteja ciente de que, se você não configurar corretamente os webhooks do Stripe e os pagamentos recorrentes falharem por qualquer motivo (cartão de crédito expirado, etc.), os usuários ainda terão acesso ao grupo. Para que o Stripe cancele automaticamente as assinaturas, certifique-se de configurar suas configurações de Gerenciar pagamentos com falha de forma semelhante à imagem abaixo e configure webhooks conforme descrito acima.
Atualizar Informações de Pagamento
Os usuários podem atualizar seu cartão usado para assinaturas individuais visitando a página de faturamento e clicando no botão de edição ao lado da assinatura, o que abrirá esta tela:
Stripe Checkout com Tabelas de Preços do Stripe
Você também pode optar por substituir as páginas de produto e checkout do Plugin de Assinatura e, em vez disso, usar Stripe Checkout com Tabelas de Preços do Stripe.
No seu Painel do Stripe:
- Após criar os produtos no Discourse, vá para Produtos > Catálogo de Produtos
- Clique no produto que deseja incluir na tabela de preços
- Clique em
Editar produto Mais Opçõese insira o seguinte emMetadados:- Chave:
group_name - Valor: O nome do grupo no Discourse (por exemplo,
trust_level_0)
- Chave:
- Clique em
Atualizar produtopara salvar
Certifique-se de que o nome do grupo corresponda ao grupo selecionado em
User_Groupsno Discourse
Crie sua tabela de preços do Stripe
- Vá para Produtos > Tabelas de Preços
- Crie uma nova tabela e adicione os produtos que você acabou de criar
- Após publicar a tabela, copie o ID da tabela de preços encontrado no código de incorporação (começa com
prctbl_...) - Cole o ID da tabela de preços em seu
discourse_subscriptions_pricing_table_ide ative a configuração da tabela de preços de assinaturas. - Clique nos marcadores verdes para salvar ambas as configurações.
Etapa recomendada:
Ao configurar a Tabela de Preços no Stripe, recomenda-se redirecionar o usuário para seu site após o término do checkout; caso contrário, eles permanecerão em uma página de confirmação do Stripe sem um link de volta ao seu site.
Redirecionar para https://<seu-site>/my/billing/subscriptions é uma boa escolha para assinaturas. Para pagamentos únicos, você pode vincular diretamente a https://<seu-site>/my/billing/payments.
Cobrança Automática de Impostos
Para ativar a Cobrança Automática de Impostos, marque a caixa de Configuração do Site para discourse_subscriptions_enable_automatic_tax.
Se você ativá-lo, mas não tiver configurado sua instância do Stripe corretamente para cobrar impostos, os usuários podem ver este pop-up após concluir o processo de checkout:
Há este guia para mais informações, mas não deve haver muito a fazer, já que o plugin agora está passando o parâmetro apropriado automatic_tax[enabled]=true (etapa 5).
Certifique-se de configurar suas inscrições (etapa 4) também:
Aqui está um exemplo de transação do Plugin de Assinatura do Discourse no Stripe mostrando que o imposto foi coletado automaticamente:
Configurações
| Nome | Descrição |
|---|---|
| discourse subscriptions enabled | Ativa o plugin Discourse Subscriptions. |
| discourse subscriptions extra nav subscribe | Exibe o botão Inscrever-se na navegação principal |
| discourse subscriptions public key | Chave Publicável do Stripe |
| discourse subscriptions secret key | Chave Secreta do Stripe |
| discourse subscriptions webhook secret | Segredo do Webhook do Stripe |
| discourse subscriptions currency | Código da Moeda Padrão. Isso pode ser substituído ao criar um plano de assinatura. |
| discourse subscriptions campaign enabled | Ativa um banner de campanha para promover o apoio financeiro a esta comunidade. |
| discourse subscriptions campaign goal | A meta numérica para sua campanha de apoio (assinantes ou valor arrecadado). |
| discourse subscriptions campaign type | Seleciona o tipo de campanha a ser executada (assinantes ou valor mensal arrecadado). |
| discourse subscriptions campaign banner location | Seleciona a localização do banner da campanha (topo ou barra lateral). |
| discourse subscriptions campaign banner bg image | Carrega uma imagem personalizada para usar como fundo no banner da campanha. |
| discourse subscriptions campaign banner shadow color | Seleciona a cor da sombra do banner da campanha. |
| discourse subscriptions campaign show contributors | Exibe avatares das compras mais recentes de produtos de assinatura. |
| discourse subscriptions campaign product | O ID do produto do Stripe a ser enviado aos apoiadores quando clicarem no botão na campanha. Se esta configuração estiver vazia, os apoiadores serão direcionados para a página principal de produtos. |
| discourse subscriptions campaign grant | Concede ao usuário um mês gratuito de assinatura |
| discourse subscriptions pricing table id | O ID da tabela de preços do Stripe do código de incorporação |
| discourse subscriptions pricing table enabled | Ativa o uso da tabela de preços do Stripe e substitui a página de inscrição existente |
| discourse_subscriptions_enable_automatic_tax | Alterna se o imposto sobre vendas será cobrado. Requer alguma configuração no Stripe. |
| discourse_subscriptions_enable_verbose_logging | Ativa logs mais detalhados para auxiliar na depuração. Por favor, não deixe ativado permanentemente em produção. |
Hospedado por nós? Este plugin está disponível em nossos planos de hospedagem Pro, Business e Enterprise Subscriptions | Discourse - Civilized Discussion