Introdução


Integrar uma plataforma de pagamento ao seu site eDirectory é essencial para receber pagamentos dos seus usuários quando eles assinarem a sua plataforma. O Stripe é uma solução de pagamento robusta que permite oferecer pagamentos únicos, assinaturas e incentivos de teste. Este artigo orientará você 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 os ciclos de cobrança para economizar tempo e garantir uma receita consistente.
  • Incentivos de Teste: Atraia mais usuários oferecendo promoções, como um período de teste gratuito no primeiro mês.

Etapas para Integrar o Stripe


Etapa 1: Obtenha a API do Stripe


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

  1. Acesse o site do Stripe: Visite o site do Stripe.

  2. Crie uma conta: Caso ainda não tenha uma conta no Stripe, crie uma.

  3. Confirme sua conta: Verifique seu e-mail para confirmar a conta e faça login no painel do Stripe.

  4. Ative sua conta: Adicione as informações do seu cartão de crédito para ativar sua conta.

    Nota: O modo de teste deve estar desativado para utilizar as chaves de API em ambiente de produção. Para desativar o modo de teste, o Stripe exige informações válidas de cartão de crédito.
    
  5. Obtenha a Chave Secreta:

    • No menu à esquerda, clique na opção Desenvolvedores.
    • Clique na aba Chaves de API.
  6. 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: Habilite 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 administrativo do seu site.
  2. Abra as Configurações: Vá até a aba Configurações, selecione Gerenciar Planos e Preços e clique na aba Formas de Pagamento. 
  3. Habilite o Stripe:
    • Marque a caixa Ativar Stripe.
    • Cole a Chave Secreta do Stripe no campo Chave de API.
  4. Habilite Pagamentos Recorrentes: Caso deseje utilizar pagamentos recorrentes, ative esta funcionalidade.
  5. Configure Planos de Teste:
    • Vá até Gerenciar Planos e Preços.
    • Ative os testes para planos específicos e defina a duração do período de teste em dias. 

Etapa 3: Configure a URL do Webhook


Para garantir que os pagamentos de assinaturas sejam renovados automaticamente, você precisa configurar uma URL de webhook no Stripe.

  1. Faça login no Stripe: Acesse o painel do Stripe.

  2. Abra a aba de Webhooks: No menu 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 correspondente e clique em Adicionar eventos.
  6. Salve o Endpoint: Clique em Adicionar endpoint para finalizar a configuração.

    Nota: Se você utiliza 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 simplificada para seus usuários, enquanto mantém processos de cobrança flexíveis e automatizados. Se você tiver dúvidas ou precisar de assistência, entre em contato com a nossa equipe de suporte pelo e-mail [email protected].