Introdução


Integrar um gateway de pagamento ao seu site eDirectory é essencial para receber pagamentos dos seus usuários quando eles assinarem sua plataforma. O Stripe é uma solução de pagamento poderosa que permite oferecer pagamentos únicos, assinaturas e incentivos de teste. Este artigo irá guiá-lo pelas etapas para integrar o Stripe ao seu site eDirectory.

Benefícios de Usar o Stripe

  • Assinaturas: Ofereça opções de pagamento flexíveis para seus anunciantes.
  • Pagamentos Recorrentes: Automatize ciclos de cobrança para economizar tempo e garantir uma receita consistente.
  • Incentivos de Teste: Ofereça promoções, como um teste gratuito no primeiro mês, para atrair mais usuários.


Etapas para Integrar o Stripe


Etapa 1: Obter a API do Stripe


Antes de habilitar o Stripe no seu site eDirectory, você precisa obter a chave da API no painel do Stripe.

  1. Acesse o Site do Stripe: Visite o site do Stripe.
  2. Crie uma Conta: Se ainda não tiver uma conta no Stripe, crie uma.
  3. Confirme Sua Conta: Verifique seu e-mail para confirmar sua conta e faça login no painel do Stripe.
  4. Ative Sua Conta: Adicione informações de cartão de crédito para ativar sua conta.
Nota: O modo de teste deve estar desativado para usar as chaves em ambiente de produção. Certifique-se de desativar o modo de teste no painel do Stripe. Para isso, o Stripe exige detalhes válidos de cartão de crédito.


  1. Obtenha a Chave Secreta:
    • No menu à esquerda, clique na opção Desenvolvedores.
    • Clique na aba Chaves de API.
  2. Revele a Chave Secreta:
    • Localize a Chave Secreta.
    • Clique no botão "Revelar chave ativa" e copie a chave revelada.
Atenção: A chave só será exibida uma vez. Certifique-se de copiá-la antes de clicar em "Concluído".


Etapa 2: Habilitar o Stripe no eDirectory


Agora que você tem a chave de API do Stripe, siga estas etapas para habilitar o Stripe no seu site eDirectory: 

  1. Faça Login no Administrador do Site: Acesse o painel de administração do seu site.
  2. Abra as Configurações: Selecione Produtos e Planos no submenu.
  3. Clique em Configurações Adicionais e Gateways de Pagamento. 
  4. Habilite o Stripe: Marque a caixa Habilitar Stripe.
  5. Cole a API do Stripe: Insira a chave da API no campo correspondente e salve as alterações. 

       6. Habilite a Função de Cobrança Automática: Caso deseje usar pagamentos recorrentes, ative esta função. 

     7. Configure Planos de Teste:

  • Após configurar o Stripe, vá até Produtos e Planos → Planos para adicionar um novo plano. No formulário de criação de planos, você encontrará um campo onde poderá especificar o número de dias que um cliente pode usar o plano em teste.  
  • Ative os testes para planos específicos e defina a duração em dias. 
Atenção: A funcionalidade de teste está disponível apenas para a plataforma de pagamento Stripe, e o usuário só terá o período de teste se optar por pagar via Stripe (cartão de crédito). Para mais informações sobre como adicionar um plano, consulte este artigo: Produtos e Planos para Novos Clientes

Etapa 3: Configure a URL do Webhook


Para garantir que os pagamentos de assinaturas sejam renovados automaticamente, configure uma URL de webhook no Stripe.

  1. Faça Login no Stripe: Acesse o painel do Stripe.
  2. Abra a Aba Webhooks: No menu esquerdo, em Desenvolvedores, clique na aba Webhooks.
  3. Adicione um Novo Endpoint: Clique em + Adicionar endpoint. 
  4. Insira a URL do Webhook: Combine o domínio do seu site com a seguinte extensão:
    sponsors/billing/stripe_webhook.php
    Exemplo: https://seudominio.com/sponsors/billing/stripe_webhook.php

  5. Selecione os Eventos:
    • Clique em Selecionar eventos.
    • Busque por invoice.payment_succeeded, marque a caixa e clique em Adicionar eventos.

  6. Salve o Endpoint: Clique em Adicionar endpoint  para concluir a configuração.
Nota: Se você usa complementos ou múltiplos domínios, será necessário criar um webhook para cada domínio.

Conclusão

Integrar o Stripe ao seu site eDirectory permite oferecer uma experiência de pagamento perfeita para seus usuários, mantendo processos de cobrança flexíveis e automatizados. Caso tenha dúvidas ou precise de assistência, entre em contato com nossa equipe de suporte pelo e-mail [email protected].